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What will you learn from this book? 

Head First C# is a complete learning experience for programming 
with C# ， XAML, the .NET Framework, and Visual Studio. Built for 
your brain, this book keeps you engaged from the first chapter, 
where you’ll build a fully functional video game. After that, you’ll 
learn about classes and object-oriented programming, draw graph¬ 
ics and animation, query your data with LINQ, and serialize it to 
files. And you’ll do it all by building games, solving puzzles, and 
doing hands-on projects. By the time you’re done you’ll be a solid 
C# programmer, and you’ll have a great time along the way! 
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Inkeritance 

Encapsulation 

Abstraction 


Why does this book look so different? 

We think your time is too valuable to spend struggling with new 
concepts. Using the latest research in cognitive science and learning 
theory to craft a multi-sensory learning experience, Head First C# uses a 
visually rich format designed for the way your brain works, not a text- 
heavy approach that puts you to sleep. 
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“If you want to learn 
C# in depth and have 
fun doing it, this is 
THE book for you.” 

— Andy Parker, 
fledgling C# programmer 

“Head First C# will 
guide beginners of all 
sorts to a long and 
productive relation¬ 
ship with C# and the 
.NET Prainewo]?k.” 

—— Chris Burrows, 
Developer on Microsoft’s 
C# Compiler team 

“Head First C# got 
me up to speed in 
no time for my first 
large scale C# 
development project 
at work — I highly 
recommend 比 .” 

— Shalewa Odusanya, 
Technical Account Manager, 

Google 
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Advance Praise for Head First C# 


“Head First C# is a great book, both for brand new developers and developers like myself coming from 
a Java background. No assumptions are made as to the reader’s proficiency yet the material builds up 
quickly enough for those who are not complete newbies — a hard balance to strike. This book got me up 
to speed in no time for my first large scale G# development project at work — I highly recommend it.” 

一 Shalewa Odusanya, Technical Account Manager，Google 

“Head First C# is an excellent, simple, and fun way of learning G#. It’s the best piece for G# beginners 
I’ve ever seen — the samples are clear, the topics are concise and well written. The mini-games that guide 
you through the different programming challenges will definitely stick the knowledge to your brain. A 
great learn-by-doing book!” 

— Johnny Halife, Chief Architect, Mural, ly 

“Head First C# is a comprehensive guide to learning G# that reads like a conversation with a friend. The 
many coding challenges keep it fun, even when the concepts are tough.” 

—— Rebeca Duhn-Krahn, founding partner at Semphore Solutions 

“I’ve never read a computer book cover to cover, but this one held my interest from the first page to the 
last. If you want to learn C# in depth and have fun doing it, this is THE book for you.” 

—— Andy Parker, fledgling C# programmer 

“It’s hard to really learn a programming language without good engaging examples, and this book is full 
of them! Head First C# will guide beginners of all sorts to a long and productive relationship with G# 
and the .NET Framework.” 

—— Chris Burrows, developer for Microsoft’s C# Compiler team 

“With Head First C #，Andrew and Jenny have presented an excellent tutorial on learning G#. It is very 
approachable while covering a great amount of detail in a unique style. If you’ve been turned off by 
more conventional books on G#, you’ll love this one.” 

— Jay Hilyard, software developer, co-author of C# 3.0 Cookbook 

“I’d reccomend this book to anyone looking for a great introduction into the world of programming and 
G#. From the first page onwards, the authors walks the reader through some of the more challenging 
concepts of G# in a simple, easy-to-follow way. At the end of some of the larger projects/labs, the 
reader can look back at their programs and stand in awe of what they’ve accomplished.” 

—— David Sterling, developer for Microsoft’s Visual C# Compiler team 

“Head First C# is a highly enjoyable tutorial, full of memorable examples and entertaining exercises. Its 
lively style is sure to captivate readers — from the humorously annotated examples, to the Fireside Chats, 
where the abstract class and interface butt heads in a heated argument! For anyone new to programming, 
there’s no better way to dive in.” 

— Joseph Albahari, C# Design Architect at Egton Medical Information Systems, 
the UK’s largest primary healthcare software supplier, 
co-author of C# 3.0 in a Nutshell 













“[Head First C#] was an easy book to read and understand. I will recommend this book to any developer 
wanting to jump into the G# waters. I will recommend it to the advanced developer that wants to 
understand better what is happening with their code. [I will recommend it to developers who] want to 
find a better way to explain how G# works to their less-seasoned developer friends.” 

— Giuseppe Turitto, C# and ASP.NET developer for Cornwall Consulting Group 

“Andrew and Jenny have crafted another stimulating Head First learning experience. Grab a pencil, a 
computer, and enjoy the ride as you engage your left brain, right brain, and funny bone.” 

—— Bill Mietelski，software engineer 

“Going through this Head First C# book was a great experience. I have not come across a book series 
which actually teaches you so well... .This is a book I would definitely recommend to people wanting to 
learn C #，， 

— Krishna Pala, MCP 

Praise for other Head First books 


“I feel like a thousand pounds of books have just been lifted off of my head.” 

— Ward Cunningham, inventor of the Wiki and founder of the Hillside Group 


“Just the right tone for the geeked-out, casual-cool guru coder in all of us. The right reference for 
practical development strategies — gets my brain going without having to slog through a bunch of tired 
stale professor-speak.” 

—— Travis Kalanick, Founder of Scour and Red Swoosh 
Member of the MIT TR100 


“There are books you buy, books you keep, books you keep on your desk, and thanks to O’Reilly and the 
Head First crew, there is the penultimate category, Head First books. They’re the ones that are dog¬ 
eared, mangled, and carried everywhere. Head First SQL is at the top of my stack. Heck, even the PDF I 
have for review is tattered and torn.” 

—— Bill Sawyer, ATG Curriculum Manager, Oracle 


“This book’s admirable clarity, humor and substantial doses of clever make it the sort of book that helps 
even non-programmers think well about problem-solving.” 

—— Cory Doctorow, co-editor of Boing Boing 
Author, Down and Out in the Magic Kingdom 
and Someone Comes to Town，Someone Leaves Town 






Praise for other Head First books 


“I received the book yesterday and started to read it., .and I couldn’t stop. This is definitely tres ‘cool.’ It 
is fun, but they cover a lot of ground and they are right to the point. I’m really impressed.” 

—— Erich Gamma, IBM Distinguished Engineer, and co-author of 
Design Patterns 


“One of the funniest and smartest books on software design I’ve ever read.” 

—— Aaron LaBerge, VP Technology, ESPN.com 


“What used to be a long trial and error learning process has now been reduced neatly into an engaging 
paperback.” 

— Mike Davidson, CEO, Newsvine, Inc. 


“Elegant design is at the core of every chapter here, each concept conveyed with equal doses of 
pragmatism and wit.” 

—— Ken Goldstein, Executive Vice President, Disney Online 


“Usually when reading through a book or article on design patterns, I’d have to occasionally stick myself 
in the eye with something just to make sure I was paying attention. Not with this book. Odd as it may 
sound, this book makes learning about design patterns fun. 

u While other books on design patterns are saying 'Bueller... Bueller... Bueller..this book is on the float 
belting out 'Shake it up, baby!’’’ 

—— Eric Wuehler 


“I literally love this book. In fact, I kissed this book in front of my wife.” 


Satish Kumar 
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st^irt tmldin^ With C# 

Build something cool ， fast! 

Want to build great apps really fast? 

With C#, you’ve got a great programming language and a valuable tool at 
your fingertips. With the Visual Studio IDE, you’ll never have to spend hours 
writing obscure code to get a button working again. Even better, you’ll be able to 
build really cool software, rather than remembering which bit of code was for 
the name of a button, and which one was for its label. Sound appealing? Turn 



the page, and let’s get programming. 

Why you should learn G# 

C# and the Visual Studio IDE make lots of things easy 
What you do in Visual Studio … 

What Visual Studio does for you... 

Aliens attack! 
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Only you can help save the Earth 
Here’s what you’re going to build 
Start with a blank application 
Set up the grid for your page 
Add controls to your grid 

Use properties to change how the controls look 

Controls make the game work 

You’ve set the stage for the game 

What you’ll do next 

Add a method that does something 

Fill in the code for your method 

Finish the method and run your program 

Here’s what you’ve done so far 

Add timers to manage the gameplay 

Make the Start button work 

Run the program to see your progress 

Add code to make your controls interact with the player 

Dragging humans onto enemies ends the game 

Your game is now playable 

Make your enemies look like aliens 

Add a splash screen and a tile 

Publish your app 

Use the Remote Debugger to sideload your app 
Start remote debugging 
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ft’s all just coje 

Under the hood 

You’re a programmer, not just an IDE user. 

You can get a lot of work done using the IDE. But there’s only so far it 
can take you. Sure, there are a lot of repetitive tasks that you do when 
you build an application. And the IDE is great at doing those things for 
you. But working with the IDE is only the beginning. You can get your 
programs to do so much more — and writing C# code is how you do it. 
Once you get the hang of coding, there’s nothing your programs can’t do. 
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objects ： get oriented! 

Making Code Make Sense 

Every program you write solves a problem. 

When you’re building a program, it’s always a good idea to start by thinking about what 
problem your program’s supposed to solve. That’s why objects are really useful. They 
let you structure your code based on the problem it’s solving, so that you can spend your 
time thinking about the problem you need to work on rather than getting bogged down in 
the mechanics of writing code. When you use objects right, you end up with code that’s 
intuitive to write, and easy to read and change. 
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GetTimeToDestination() 

TotalDistance() 
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How Mike thinks about his problems 

How Mike’s car navigation system thinks about his problems 
Mike’s Navigator class has methods to set and modify routes 
Use what you’ve learned to build a program that uses a class 
Mike gets an idea 

Mike can use objects to solve his problem 

You use a class to build an object 

When you create a new object from a class, 
it’s called an instance of that class 

A better solution.. .brought to you by objects! 

An instance uses fields to keep track of things 

Let’s create some instances! 

Thanks for the memory 

What’s on your program’s mind 

You can use class and method names to make your code intuitive 
Give your classes a natural structure 

Glass diagrams help you organize your classes so they make sense 

Build a class to work with some guys 

Create a project for your guys 

Build a form to interact with the guys 

There’s an easier way to initialize objects 
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Dog fido; 

Dog lucky = new 


fido = new Dog() 


lucky = null; 


types and references 


4 It’s 10:00. Do you know where your data is? 

Data type, database, Lieutenant Commander Data... 

it’S all important stuff. Without data, your programs are useless. You 
need information from your users, and you use that to look up or produce new 
information to give back to them. In fact, almost everything you do in programming 
involves working with data in one way or another. In this chapter, you’ll learn the 
ins and outs of C#’s data types, see how to work with data in your program, and 
even figure out a few dirty secrets about objects (pssst … objects are data, too). 


The variable’s type determines what kind of data it can store 142 

A variable is like a data to-go cup 144 

10 pounds of data in a 5-pound bag 145 

Even when a number is the right size, you can’t just assign it to any variable 146 
When you cast a value that’s too big, C# will adjust it automatically 147 

G# does some casting automatically 148 


Dog(); 









When you call a method, the arguments must be compatible 
with the types of the parameters 

Debug the mileage calculator 

Combining = with an operator 

Objects use variables, too 

Refer to your objects with reference variables 

References are like labels for your object 

If there aren’t any more references, your object gets garbage-collected 
Multiple references and their side effects 
Two references means TWO ways to change an object’s data 
A special case: arrays 

Arrays can contain a bunch of reference variables, too 
Welcome to Sloppy Joe’s Budget House o’ Discount Sandwiches! 
Objects use references to talk to each other 
Where no object has gone before 
Build a typing game 

Controls are objects, just like any other object 
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A Day at the Races 

Joe, Bob, and A1 love going to the track, but they’re 
tired, of losing all their money. They need, you to build, a 
simulator for them so they can figure out winners before 
they lay their money down. And, if you do a good job, 
they’ll cut you in on their profits. 


The spec: build a racetrack simulator 188 

The Finished Product 196 
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Keep your privates... private 

Ever wished for a little more privacy? 

Sometimes your objects feel the same way. Just like you don’t want anybody you 
don’t trust reading your journal or paging through your bank statements, good objects 
don't let other objects go poking around their fields. In this chapter, you’re going to 
learn about the power of encapsulation. You’ll make your object’s data private, and 
add methods to protect how that data is accessed. 


Kathleen is an event planner 
What does the estimator do? 



You’re going to build a program for Kathleen 
Kathleen’s test drive 

Each option should be calculated individually 
It’s easy to accidentally misuse your objects 

Encapsulation means keeping some of the data in a class private 
Use encapsulation to control access to your class’s methods and fields 



But is the RealName field REALLY protected? 

Private fields and methods can only be accessed from inside the class 


Encapsulation keeps your data pristine 
Properties make encapsulation easier 
Build an application to test the Farmer class 



Use automatic properties to finish the class 
What if we want to change the feed multiplier? 
Use a constructor to initialize private fields 
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Your object’s family tree 

Sometimes you DO want to be just like your parents. 

Ever run across an object that almost does exactly what you want your object to do? 
Found yourself wishing that if you could just change a few things, that object would 
be perfect? Well, that’s just one reason that inheritance is one of the most powerful 
concepts and techniques in the C# language. Before you’re through with this chapter, 


you’ll learn how to subclass an object to get its behavior, but keep the flexibility to 



m 


make changes to that behavior. You’ll avoid duplicate code, model the real world 
more closely, and end up with code that’s easier to maintain. 
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When your classes use inheritance, you only need to write your code once 248 
Build up your class model by starting general and getting more specific 249 
How would you design a zoo simulator? 250 

Use inheritance to avoid duplicate code in subclasses 251 

Different animals make different noises 252 

Think about how to group the animals 253 

Create the class hierarchy 254 

Every subclass extends its base class 255 

Use a colon to inherit from a base class 256 
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A subclass can override methods to change or replace methods it inherited 260 


Any place where you can use a base class, 

you can use one of its subclasses instead 261 

A subclass can hide methods in the superclass 268 

Use the override and virtual keywords to inherit behavior 270 

A subclass can access its base class using the base keyword 272 

When a base class has a constructor, your subclass needs one, too 273 

Now you’re ready to finish the job for Kathleen! 274 

Build a beehive management system 279 

How you’ll build the beehive management system 280 
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Interfaces and abstract classes 



Making classes keep their promises 

Actions speak louder than words. 

Sometimes you need to group your objects together based on the things they can 
do rather than the classes they inherit from. That’s where interfaces come in — they 


let you work with any class that can do the job. But with great power comes great 


% Inkeritance 




responsibility, and any class that implements an interface must promise to fulfill all of 
its obligations... or the compiler will break their kneecaps, see? 




Let’s get back to bee-sics 

We can use inheritance to create classes for different types of bees 
An interface tells a class that it must implement 


294 

295 


Abstraction 


Encapsulation 




Polymorpkism 


Location 

Name 

Exits 

Description 


certain methods and properties 296 

Use the interface keyword to define an interface 297 

Now you can create an instance of Nectar Stinger that does both jobs 298 

Glasses that implement interfaces have to include 

ALL of the interface’s methods 299 

Get a little practice using interfaces 300 

You can’t instantiate an interface, but you can reference an interface 302 

Interface references work just like object references 303 

You can find out if a class implements a certain interface with “is” 304 

Interfaces can inherit from other interfaces 305 


The RoboBee 4000 can do a worker bee’s job without using valuable honey 306 



Room 


Outside 

decoration: 
private string 
field 


hot: private 
bool field 






A CoffeeMaker is also an Appliance 

Upcasting works with both objects and interfaces 

Downcasting lets you turn your appliance back into a coffee maker 

Upcasting and downcasting work with interfaces, too 

There’s more than just public and private 

Access modifiers change visibility 

Some classes should never be instantiated 

An abstract class is like a cross between a class and an interface 
Like we said, some classes should never be instantiated 
An abstract method doesn’t have a body 
The Deadly Diamond of Death! 

Polymorphism means that one object can take many different forms 
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enums and cpllectlpns 



Storing lots of data 

When it rains, it pours. 

In the real world, you don’t get to handle your data in tiny little bits and pieces. 
No, your data’s going to come at you in loads, piles, and bunches. You’ll need 
some pretty powerful tools to organize all of it, and that’s where collections 


come in. They let you store, sort, and manage all the data that your programs 



need to pore through. That way, you can think about writing programs to work 
with your data, and let the collections worry about keeping track of it for you. 

Strings don’t always work for storing categories of data 352 

Enums let you work with a set of valid values 353 










Lists are more flexible than arrays 
Lists shrink and grow dynamically 
Generics can store any type 

Collection initializers are similar to object initializers 
Lists are easy, but SORTING can be tricky 


IGomparable<Duck> helps your list sort its ducks 

Use IGomparer to tell your List how to sort 

Create an instance of your comparer object 

IGomparer can do complex comparisons 

Overriding a ToStringQ method lets an object describe itself 

Update your foreach loops to let your Ducks and Cards print themselves 

When you write a foreach loop, you’re using IEnumerable<T> 

You can upcast an entire list using IEnumerable 
You can build your own overloaded methods 
Use a dictionary to store keys and values 
The dictionary functionality rundown 
Build a program that uses a dictionary 
And yet MORE collection types... 

A queue is FIFO — First In, First Out 
A stack is LIFO —— Last In, First Out 
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Enums let you represent numbers with names 
Arrays are hard to work with 

Lists make it easy to store collections of... anything 
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reading and writing ¥iles 

Save the last byte for me! 

Sometimes it pays to be a little persistent. 

So far, all of your programs have been pretty short-lived. They fire up, run for 
a while, and shut down. But that’s not always enough, especially when you’re 
dealing with important information. You need to be able to save your work. In 
this chapter, we’ll look at how to write data to a file, and then how to read that 
information back in from a file. You’ll learn about the .NET stream classes, 
and also take a look at the mysteries of hexadecimal and binary. 




.NET uses streams to read and write data 
Different streams read and write different things 
A FileStream reads and writes bytes to a file 
Write text to a file in three simple steps 
The Swindler launches another diabolical plan 
Reading and writing using two objects 
Data can go through more than one stream 
Use built-in objects to pop up standard dialog boxes 
Dialog boxes are just another WinForms control 

Use the built-in File and Directory classes to work with files and directories 
Use file dialogs to open and save files (all with just a few lines of code) 
IDisposable makes sure your objects are disposed of properly 
Avoid filesystem errors with using statements 
Use a switch statement to choose the right option 
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Add an overloaded DeckQ constructor that reads a deck of cards 

in from a file 439 

When an object is serialized, all of the objects it refers to get serialized, too...443 

Serialization lets you read or write a whole object graph all at once 444 

•NET uses Unicode to store characters and text 449 

C# can use byte arrays to move data around 450 

Use a Binary Writer to write binary data 451 

You can read and write serialized files manually, too 453 

Find where the files differ, and use that information to alter them 454 

Working with binary files can be tricky 455 

Use file streams to build a hex dumper 456 

Use Stream.ReadQ to read bytes from a stream 458 
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C#Lab3 

The Quest 

Your job is to build, an adventure game where a mighty 
adventurer is on a quest to defeat level after level of 
deadly enemies. You’ll build a turn-based, system, which 
means the player makes one move and. then the enemies 
make one move. The player can move or attack, and then 
each enemy gets a chance to move and. attack. The game 
keeps going until the player either defeats all the enemies 
on all seven levels or dies. 


The spec: build an adventure game 
The fun’s just beginning! 
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Taking your apps to the next level 

You’re ready for a whole new world of app development. 

Using WinForms to build Windows Desktop apps is a great way to learn important C# 
concepts, but there’s so much more you can do with your programs. In this chapter, 
you’ll use XAML to design your Windows Store apps, you’ll learn how to build pages 
to fit any device, integrate your data into your pages with data binding, and use 
Visual Studio to cut through the mystery of XAML pages by exploring the objects 


created by your XAML code. 

The grid is made up of 20-pixel 
squares called units. 


Each unit is broken down 
into 5-pixel sub-units 


V A 

® GoFis 

◄ - ♦ 

T 


Your Name 



Brian’s running Windows 8 

Windows Forms use an object graph set up by the IDE 

Use the IDE to explore the object graph 

Windows Store apps use XAML to create UI objects 

Redesign the Go Fish! form as a Windows Store app page 

Page layout starts with controls 

Rows and columns can resize to match the page size 

Use the grid system to lay out app pages 

Data binding connects your XAML pages to your classes 

XAML controls can contain text...and more 



Use data binding to build Sloppy Joe a better menu 

Use static resources to declare your objects in XAML 

Use a data template to display objects 

INotifyPropertyGhanged lets bound objects send updates 

Modify MenuMaker to notify you when the 
GeneratedDate property changes 
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BINDING 

ItemsSource="{Binding} 
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Writing files right 

Nobody likes to be kept waiting...especially not users. 

Computers are good at doing lots of things at once, so there’s no reason your apps 
shouldn’t be able to as well. In this chapter, you’ll learn how to keep your apps responsive 

by building asynchronous methods. You’ll also learn how to use the built-in file 
pickers and message dialogs and asynchronous file input and output without 


freezing up your apps. Combine this with data contract serialization, and you’ve got the 
makings of a thoroughly modern app. 


Brian runs into file trouble 



Windows Store apps use await to be more responsive 
Use the FilelO class to read and write files 
Build a slightly less simple text editor 

A data contract is an abstract definition of your object’s data 

Use async methods to find and open files 

KnownFolders helps you access high-profile folders 

The whole object graph is serialized to XML 

Stream some Guy objects to your app’s local folder 

Take your Guy Serializer for a test drive 

Use a Task to call one async method from another 


FilelO. 

© Ap p en d Li n esAsyn c 
© AppendT ectA&ync 
© Equals 

© Read Buff erAsync 
© ReadLinesAsync 
© ReadTextAsync 
© ReferenceEquals 
© WriteBufferA&ync 
© WriteBytesAsync 


Build Brian a new Excuse Manager app 
Separate the page, excuse, and Excuse Manager 
Create the main page for the Excuse Manager 


Add the app bar to the main page 


Build the ExcuseManager class 
Add the code-behind for the page 


Simple Text Editor 


emailToCaptajnAmazing.txt 


To: CaptainAmazing@objectville.net 
F rom: Commissioner@objectivil le.net 
Subject Can you save the day … again? 

We ve discovered the Swirxjler s plan: 

The plan -> How I II defeat Captain Amazing 

The plan -> Another genius secret plan by The Swindler 

The plan -> I'll create an army of clones and unleash them upon the citizens of Objectville. 

The plan -> Clone #0 attacks the mall 

The plan •> Clone #1 attacks downtown 

The plan -> Clone #2 attacks the mall 

The plan -> Clone #3 attacks downtown 

The plan -> Clone #4 attacks the mall 

The plan -> Clone #5 attacks downtown 

The plan -> Clone #6 attacks the mall 
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exception h^ndlln^ 

Putting out fires gets old 

rogrammers aren’t meant to be firefighters. 

ou’ve worked your tail off, waded through technical manuals and a few engaging 
ead First books, and you’ve reached the pinnacle of your profession. But you’re 
still getting panicked phone calls in the middle of the night from work because your 
program crashes, or doesn’t behave like it’s supposed to. Nothing pulls you 
out of the programming groove like having to fix a strange bug...but with exception 
handling, you can write code to deal with problems that come up. Better yet, you 

can even react to those problems, and keep things running. 

Brian needs his excuses to be mobile 


VO^W, THIS P12^12AM , S 12BAUUY STABU6 






our program^n^ 




user 


your class, now with 
exception handling 



o 


O 


UH OWi WHAT 
TH6 H66K. 
HAPP6N6D? 


°^ect 


When your program throws an exception, 

.NET generates an Exception object 

Brian’s code did something unexpected 

All exception objects inherit from Exception 

The debugger helps you track down 
and prevent exceptions in your code 

Use the IDE’s debugger to ferret out exactly 
what went wrong in the Excuse Manager 

Uh oh —— the code’s still got problems... 

Handle exceptions with try and catch 

What happens when a method you want to call is risky? 

Use the debugger to follow the try/catch flow 

If you have code that ALWAYS should run, use a finally block 

Use the Exception object to get information about the problem 

Use more than one catch block to handle 
multiple types of exceptions 

One class throws an exception that a method 
in another class can catch 


int[] anArray = {3, 4, 1, 11}; 
int aValue = anArray[15]; 
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An easy way to avoid a lot of problems: 

using gives you try and finally for free 601 

Exception avoidance: implement IDisposable to do your own cleanup 602 
The worst catch block EVER: catch-all plus comments 604 

A few simple ideas for exception handling 606 



Watch 1 


Name 


Value 


曰 _ 


the bounds of 


田 • 
田 A 


田 


田 A 
田 • 


[System.IndexOutOfRangeException] 
Data 

HelpLink 

HResult 

InnerException 

Message 

Source 

StackTrace 

TargetSite 

Static members 

Non-Public members 


{"Index was outside the bounds of the array."} 
{System.Collections.ListDictionarylnternal} 
null 

-2146233080 
null 

"Index was outside the bounds of the array." 
"ConsoleApplicationl " 

"at ConsoleApplicationl .Program.Main(Strinc ^ 
{Void Main(System.String[])} 
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Locals Watch 1 
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Your last chance to DO something.. .your object’s finalizer 
When EXACTLY does a flnalizer run? 

Dispose() works with using; flnalizers work with garbage collection 

Finalizers can’t depend on stability 

Make an object serialize itself in its Dispose 。 

A struct looks like an object... 

•. .but isn’t an object 

Values get copied; references get assigned 
Structs are value types; objects are reference types 
The stack vs. the heap: more on memory 

Use out parameters to make a method return more than one value 
Pass by reference using the ref modifier 
Use optional parameters to set default values 
Use nullable types when you need nonexistent values 
Nullable types help you make your programs more robust 
“Captain” Amazing...not so much 

Extension methods add new behavior to EXISTING classes 
Extending a fundamental type: string 
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imryhig data and apps with Lijs[(^ 

Get control of your data 

It’s a data-driven world.• .it’s good to know how to live in it. 

Gone are the days when you could program for days, even weeks, without dealing 
with loads of data. Today, everything is about data. And that’s where LINQ comes in. 
LINQ not only lets you query data in a simple, intuitive way, but it lets you group data 
and merge data from different data sources. And once you’ve wrangled your data 



Jimmy’s a Captain Amazing super-fan... 650 

•. .but his collection’s all over the place 651 

LINQ,can pull data from multiple sources 652 

.NET collections are already set up for LINQ 653 

LINQ,makes queries easy 654 

LINQ,is simple, but your queries don’t have to be 655 

Jimmy could use some help 658 

Start building Jimmy an app 660 

Use the new keyword to create anonymous types 663 

LINQ,is versatile 666 

Add the new queries to Jimmy’s app 668 

LINQ,can combine your results into groups 673 

Combine Jimmy’s values into groups 674 

Use join to combine two collections into one sequence 677 

Jimmy saved a bunch of dough 678 

Use semantic zoom to navigate your data 684 

Add semantic zoom to Jimmy’s app 686 

You made Jimmy’s day 691 

The IDE’s Split App template helps you build apps 

for navigating data 692 


data that let your users navigate, explore, and even zoom into the details. 




into manageable chunks, your Windows Store apps have controls for navigating 
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eVents and delegates 

What your code does when you’re not looking 

Your objects are starting to think for themselves. 

You can't always control what your objects are doing. Sometimes things...happen. And 
when they do, you want your objects to be smart enough to respond to anything that 
pops up. And that’s what events are all about. One object publishes an event, other 
objects subscribe, and everyone works together to keep things moving. Which is great, 
until you want your object to take control over who can listen. That’s when callbacks will 
come in handy. 


Border sets handled 


Grid sets handled 


The rectangle was pressed 
The grid was pressed 
The border was pressed 
The panel was pressed 


Ellipse sets handled 


Rectangle sets handled 




New IsHitTestVisible value 


Ever wish your objects could think for themselves? 

But how does an object KNOW to respond? 

When an EVENT occurs...objects listen 
One object raises its event, others listen for it... 

Then, the other objects handle the event 
Connecting the dots 

The IDE generates event handlers for you automatically 

Generic EventHandlers let you define your own event types 

Windows Forms use many different events 

One event, multiple handlers 

Windows Store apps use events for 
process lifetime management 

Add process lifetime management to Jimmy’s comics 



XAML controls use routed events 
Create an app to explore routed events 
Connecting event senders with event listeners 
A delegate STANDS IN for an actual method 
Delegates in action 
An object can subscribe to an event … 

Use a callback to control who’s listening 
A callback is just a way to use delegates 
You can use callbacks with MessageDialog commands 
Use delegates to use the Windows settings charm 
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qrcjiftectln^ apps with the mVVm pattern 

Great apps on the inside and outside 

Your apps need to be more than just visually stunning. 

When you think of design, what comes to mind? An example of great building architecture? 
A beautifully-laid-out page? A product that's as aesthetically pleasing as it is well 
engineered? Those same principles apply to your apps. In this chapter you’ll learn about 
the Model-View-ViewModel pattern and how you can use it to build well-architected, 
loosely coupled apps. Along the way you’ll learn about animation and control templates 
for your apps’ visual design, how to use converters to make data binding easier, and how 
to pull it all together to lay a solid C# foundation to build any app you want. 





The Head First Basketball Conference needs an app 

But can they agree on how to build it? 

Do you design for binding or for working with data? 

MVVM lets you design for binding and data 

Use the MVVM pattern to start building 
the basketball roster app 

User controls let you create your own controls 
The ref needs a stopwatch 

MVVM means thinking about the state of the app 
Start building the stopwatch app’s Model 
Events alert the rest of the app to state changes 
Build the view for a simple stopwatch 
Add the stopwatch ViewModel 
Converters automatically convert values for binding 
Converters can work with many different types 
Visual states make controls respond to changes 
Use Double Animation to animate double values 
Use object animations to animate object values 
Build an analog stopwatch using the same ViewModel 
UI controls can be instantiated with C# code, too 
G# can build “real” animations, too 
Create a user control to animate a picture 
Make your bees fly around a page 
Use ItemsPanelTemplate to bind controls to a Canvas 
Congratulations! (But you’re not done yet...) 
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Invaders 


G#Lab3 


Invaders 


In this lab you’ll pay homage to one of the most popular, 
revered, and. replicated, icons in video game history, a 
game that needs no further introduction. It’s time to 
build. Invaders. 


The grandfather of video games 
And yet there’s more to do... 
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tonus project! 

uild a Windows Phone app 

You’re already able to write Windows Phone apps. 

Classes, objects, XAML, encapsulation, inheritance, polymorphism, LINQ, MVVM … 
you’ve got all of the tools you need to build great Windows Store apps and desktop 
apps. But did you know that you can use these same tools to build apps for 
Windows Phone? It’s true! In this bonus project, we’ll walk you through creating a 
game for Windows Phone. And if you don’t have a Windows Phone, don’t worry — 
you’ll still be able to use the Windows Phone emulator to play it. Let’s get started! 



Bee Attack! 

Before you begin... 
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appendix ： leftovers 

The top 11 things we wanted to include 
in this book 

The fun’s just beginning! 

We’ve shown you a lot of great tools to build some really powerful software with C#. But 
there’s no way that we could include every single tool, technology, or technique in this 
book — there just aren’t enough pages. We had to make some really tough choices about 
what to include and what to leave out. Here are some of the topics that didn’t make the 
cut. But even though we couldn’t get to them, we still think that they’re important and 
useful, and we wanted to give you a small head start with them. 



4 BackgroundWorker Example 



■? BackgroundWorker example 

I I Use BackgroundWorker 
Go! Cancel 





#1. There’s so much more to Windows Store 
#2. The Basics 

#3. Namespaces and assemblies 

#4. Use BackgroundWorker to make your WinForms responsive 

#5. The Type class and GetTypeO 

#6. Equality, IEquatable, and EqualsO 

#7. Using yield return to create enumerable objects 

#8. Refactoring 

#9. Anonymous types, anonymous methods, and lambda expressions 

#10. LINQto XML 

#11. Windows Presentation Foundation 

Did you know that C# and the .NET Framework can... 
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Developer Command Prompt for VS2012 


n 



C:\Users\Public\Docunents >type HelloUorld.cs 
using System ； 
class HelloUorld < 

public static void MainCstringC] args> < 
Console.UriteLine< ,p Hello Uorld ,p >； 

> 


' : \Users\Public\Docunents >csc HelloUorld.cs 

licrosoft <R> Uisual Ctt Compiler version 4.0.30319.17929 

or Microsoft .NET Framework 4.5 

lopyright <C> Microsoft Corporation. All rights reserved 


A 


I ： \Users\Public\Docunents>HelloUorld.exe 
lello World 

' : \Users\Public\Docunents >_ 
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how to use this book 


Who is this book for? 

If you can answer “yes” to all of these: 

① Do you want to learn C#? < 

^2) Do you like to tinker — do you learn by doing, rather than 
just reading? 

^3) Do you prefer stimulating dinner party conversation 
to dry, dull, academic lectures? 

this book is for you. 


Who should probably back away from this book? 

If you can answer “yes” to any of these: 

(T) Does the idea of writing a lot of code make you bored 
and a little twitchy? 


(2) Are you a kick-butt C++ or Java programmer looking for 
a reference book? 


^3^ Are you afraid to try something different? Would 
you rather have a root canal than mix stripes with 
plaid? Do you believe that a technical book can’t be 
serious if C# concepts are anthropomorphized? 


this book is not for you. 


this book is 

+ 饮 a^yohc wi-tK a ^cdi-t ca^rdJ 


Do you know another 
programming language, 
and now you need to ramp 
up on C#? 


Are you already a good C# 
developer, but you want to 
learn more about XAML, 
Model-View-ViewModel 
(MVVM), or Windows Store 
app development? 


Do you want to get 
practice writing lots of 
code? 


If so, then lots of people 
just like you have used 
this book to do exactly 
those things! 
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the intro 


Wc know what youVe thmkmg. 


“How can this be a serious G# programming book?” 


“What’s with all the graphics?” 


“Can I actually learn it this way?” 

And we know what your is thmkmg. 







Your brain craves novelty. It’s always searching, scanning, waiting for 
something unusual. It was built that way, and it helps you stay alive. 


So what does your brain do with all the routine, ordinary, normal things 
you encounter? Everything it can to stop them from interfering with 
the brain’s real]oh — recording things that matter. It doesn’t bother 
saving the boring things; they never make it past the “this is obviously 
not important” filter. 


How does your brain know what’s important? Suppose you’re out for 
a day hike and a tiger jumps in front of you, what happens inside your 
head and body? 


And there’s no simple way to tell your brain, “Hey brain, thank you 
very much, but no matter how dull this book is, and how little I’m 
registering on the emotional Richter scale right now, I really do want 
you to keep this stuff around.” 


Neurons fire. Emotions crank up. Chemicals surge. 

And that’s how your brain knows ... 

This must be important! Don’t forget it! 

But imagine you’re at home, or in a library. It’s a safe, warm, tiger-free 
You’re studying. Getting ready for an exam. Or trying to learn some 
tough technical topic your boss thinks will take a week, ten days at 
the most. 


Just one problem. Your brain’s trying to do you a big favor. It’s trying 
to make sure that this obviously non-important content doesn’t clutter 
up scarce resources. Resources that are better spent storing the really 
big things. Like tigers. Like the danger of fire. Like how you should 
never have posted those “party” photos on your Facebook page. 
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Metacognition: thinking about thinking 


If you really want to learn, and you want to learn more quickly and more deeply, 
pay attention to how you pay attention. Think about how you think. Learn how you 
learn. 

Most of us did not take courses on metacognition or learning theory when we were 
growing up. We were expected to learn, but rarely taught to learn. 


I WOMDS12 
HOW I 6ANJ T12I6IC 
MY B12AINJ \mO 

THIS STUFF— 



So just how DO you get your brain to treat C# like 
it was a hungry tiger? 


There’s the slow, tedious way, or the faster, more effective 
way. The slow way is about sheer repetition. You obviously 
know that you are able to learn and remember even the dullest 
of topics if you keep pounding the same thing into your brain. With 
enough repetition, your brain says, “This doesn’t feel important to him, but he 
keeps looking at the same thing over and over and over, so I suppose it must be.” 


But we assume that if you’re holding this book, you really want to learn how to 
build programs in G#. And you probably don’t want to spend a lot of time. If you 
want to use what you read in this book, you need to remember what you read. And 
for that, you’ve got to understand it. To get the most from this book, or any book or 
learning experience, take responsibility for your brain. Your brain on this content. 


The trick is to get your brain to see the new material you’re learning 
as Really Important. Crucial to your well-being. As important as a 
tiger. Otherwise, you’re in for a constant battle, with your brain doing 
its best to keep the new content from sticking. 


The faster way is to do anything that increases brain activity, especially different 
types of brain activity. The things on the previous page are a big part of the solution, 
and they’re all things that have been proven to help your brain work in your favor. For 
example, studies show that putting words within the pictures they describe (as opposed to 
somewhere else in the page, like a caption or in the body text) causes your brain to try to 
makes sense of how the words and picture relate, and this causes more neurons to fire. 
More neurons firing = more chances for your brain to get that this is something worth 
paying attention to, and possibly recording. 


A conversational style helps because people tend to pay more attention when they 
perceive that they’re in a conversation, since they’re expected to follow along and hold up 
their end. The amazing thing is, your brain doesn’t necessarily care that the “conversation” 
is between you and a book! On the other hand, if the writing style is formal and dry, your 
brain perceives it the same way you experience being lectured to while sitting in a roomful 
of passive attendees. No need to stay awake. 


But pictures and conversational style are just the beginning. 
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Here's what WE did: 


We used pictures, because your brain is tuned for visuals, not text. As far as your 
brain’s concerned, a picture really is worth a thousand words. And when text and 
pictures work together, we embedded the text in the pictures because your brain 
works more effectively when the text is within the thing the text refers to, as opposed 
to in a caption or buried in the text somewhere. 


l/VKen you a dlass, you 

i-b wc-tKods, just like a 

-the layoui Viousc. 






We used redundancy, saying the same thing in different ways and with different media types, 
and multiple senses : to increase the chance that the content gets coded into more than one area 
of your brain. 


V^u d3r» use or\c blucp^rmt "to 

•wake a 内 y ^umbev o-( - houses, 

and you use or»e dlass -to 
•^ake ar>y r»urwbc»r o-f objects. 


y ILLiJ 


We used concepts and pictures in unexpected ways because your brain is tuned for novelty, 
and we used pictures and ideas with at least some emotional content, because your brain 
is tuned to pay attention to the biochemistry of emotions. That which causes you to feel 
something is more likely to be remembered, even if that feeling is nothing more than a little 

humor, surprise : or interest. 

We used a personalized, conversational style, because your brain is tuned to pay more 
attention when it believes you’re in a conversation than if it thinks you’re passively listening 
to a presentation. Your brain does this even when you’re reading. 

We included dozens of activities, because your brain is tuned to learn and remember more 
when you do things than when you read about things. And we made the paper puzzles and 
code exercises challenging-yet-do-able, because that’s what most people prefer. 



We used multiple learning styles, because joz/ might prefer step-by-step procedures, 
while someone else wants to understand the big picture first, and someone else just 
wants to see an example. But regardless of your own learning preference, everyone 
benefits from seeing the same content represented in multiple ways. 


^^BULLET POINTS 


We include content for both sides of your brain, because the more of your brain you 
engage, the more likely you are to learn and remember, and the longer you can stay focused. 
Since working one side of the brain often means giving the other side a chance to rest, you 
can be more productive at learning for a longer period of time. 

And we included stories and exercises that present more than one point of view ， 
because your brain is tuned to learn more deeply when it’s forced to make evaluations and 
judgments. 


Fireside Chats 




We included challenges, with exercises, and by asking questions that don’t always have 
a straight answer, because your brain is tuned to learn and remember when it has to work at 
something. Think about it — you can’t get your body in shape just by watching people at the 
gym. But we did our best to make sure that when you’re working hard, it’s on the right things. 

you } re not spending one extra dendrite processing a hard-to-understand example, 
or parsing difficult, jargon-laden, or overly terse text. 

We people. In stories, examples, pictures, etc., because, well, because a person. 
And your brain pays more attention to people than it does to things. 
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Here's what YOU caw do to bend 
your brain mto submission 

So, we did our part. The rest is up to you. These tips are a 
starting point; listen to your brain and figure out what works 
for you and what doesn’t. Try new things. 

Cui ihis si^k a 

伽 youm ― 饮 ‘ 


^T) Slow down. The more you understand, 
the less you have to memorize. 

Don’t just read. Stop and think. When the 
book asks you a question, don’t just skip to the 
answer. Imagine that someone really is asking 
the question. The more deeply you force your 
brain to think, the better chance you have of 
learning and remembering. 

( 2 ) Do the exercises. Write your own notes. 

We put them in, but if we did them for you, 
that would be like having someone else do 
your workouts for you. And don’t just look at 
the exercises. Use a pencil. There’s plenty of 
evidence that physical activity while learning 
can increase the learning. 

Read the “There are No Dumb Questions” 

That means all of them. They’re not optional 
sidebars — they } re part of the core content! 

Don’t skip them. 

(4) Make this the last thing you read before 
bed. Or at least the last challenging thing. 

Part of the learning (especially the transfer to 
long-term memory) happens after you put the 
book down. Your brain needs time on its own, to 
do more processing. If you put in something new 
during that processing time, some of what you 
just learned will be lost. 

( 5 ^ Drink water. Lots of it. 

Your brain works best in a nice bath of fluid. 
Dehydration (which can happen before you ever 
feel thirsty) decreases cognitive function. 


Talk about it. Out loud. 

Speaking activates a different part of the brain. 

If you’re trying to understand something, or 
increase your chance of remembering it later, say 
it out loud. Better still, try to explain it out loud 
to someone else. You’ll learn more quickly, and 
you might uncover ideas you hadn’t known were 
there when you were reading about it. 

^7) Listen to your brain. 

Pay attention to whether your brain is getting 
overloaded. If you find yourself starting to skim 
the surface or forget what you just read, it’s time 
for a break. Once you go past a certain point, you 
won’t learn faster by trying to shove more in, and 
you might even hurt the process. 

(§) Feel something. 

Your brain needs to know that this matters. Get 
involved with the stories. Make up your own 
captions for the photos. Groaning over a bad joke 
is still better than feeling nothing at all. 

( 9 ^ Write a lot of software! 

There’s only one way to learn to program: writing 
a lot of code. And that’s what you’re going to do 
throughout this book. Coding is a skill, and the only 
way to get good at it is to practice. We’re going to 
give you a lot of practice: every chapter has exercises 
that pose a problem for you to solve. Don’t just skip 
over them — a lot of the learning happens when 
you solve the exercises. We included a solution to 
each exercise — don’t be afraid to peek at the 
solution if you get stuck! (It’s easy to get snagged on 
something small.) But try to solve the problem before 
you look at the solution. And definitely get it working 
before you move on to the next part of the book. 
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What you need for this book: 


The screenshots in this book match Visual Studio 
2012 Express Edition, the latest free version 
available at the time of this printing. We’ll keep future 
printings up to date, but Microsoft typically makes 
older versions available for download. 


We wrote this book using Visual Studio Express 2012 for Windows 8 and Visual Studio Express 2012 for 
Windows Desktop. All of the screenshots that you see throughout the book were taken from those two editions 
of Visual Studio, so we recommend that you use them. You can also use Visual Studio 2012 Professional, Premium, 
Ultimate or Test Professional editions, but you’ll see some small differences (but nothing that will cause problems with 
the coding exercises throughout the book). 


SETTING UP VISUAL STUDIO 2012 EXPRESS EDITIONS - 

You can download Visual Studio Express 2012 for Windows 8 for free from Microsoft’s website. It installs cleanly alongside 
other editions, as well as previous versions: http://www.microsoft.com/visualstudio/enq/downloads 


Cli 匕 k the u Install 
Kov/ W Imk *to 
the v/cb mstallcv-, 

whi 匕 h au*tow\a*ti 匕 ally 

and 

ms-bdlls Visual Studio. 


Youll also Y\ttd b> 

a pirodud-t key, 

^iW\CM is -p\rcc -Pov -the 
E^pv-css editions (bu 七 
vc^uiv-cs you -to B 

/1/IiC.iroso^tdorw addouyrt). 


㈠ Visual Studio Express 2012 for Windows Desktop 


Visual Studio 2012 Express for Windows Desktop 

Vou can use Visual Studio Express 2012 for Windows Desktop to 

build powerful desktop apps in C#, Visual Basic, and C++. You can 
target client technologies such as Windows Presentation Foundation 
(WPF), Windows Forms, and Win32. After installation, you can try this 
product for up to 30 days. You must register to obtain a free product 
key for ongoing use after 30 days. 


Download language 

English v[ 

Installation options 

Visual Studio 2012 Express for Windows Desktop - English 


□ 


Visual Studio 2012 Express for Windows Desktop - English 


~^y 

Aflei iiibldlldliu", you edn Uy Ihis pruducl foi up Lu 30 
days. You must register to obtain a free product key for 
ongoing use after 30 days. 


Visual Studio 2012 Express for Window 
Language Pack 

The Visual Studio Express 2012 for Windows 
Pack is a free add-on that you can use to swil 
displayed in the Visual Studio user interface. 

Important: Before installing this Language Pal 


Download langnagp 


I Cesky v] 

Installation options 



Visual Studio 2012 Express for Windows Desl<| 
Pack - Cesky 


Visual Studio 

Express 2012 for Windows 8 

with Blend 


Setup requires 1.01 GB in: 


You must agree to the License Terms before you can install the product 

Visual Studio 2012 automatically sends information to Microsoft about 
your installation experience and notifies you when an update is available 
and connects you to content online. To leam more, see the Privacy 
Statement. 


y I agree to the License terms and conditions. 

y Join the Customer Experience Improvement Program to help 
improve the quality, reliability and performance of Visual Studio. 


⑦ INSTALL 


Once you’ve got it installed, you’ll need to do the same thing for Visual Studio Express 2012 for Windows Desktop. 


What to do if you don't have Windows S or can't run Visual Studio 2012 

Many of the coding exercises in this book require Windows 8. But we definitely understand that some of our readers 
may not be running it — for example, a lot of professional programmers have office computers that are running 
operating systems as old as Windows 2003, or only have Visual Studio 2010 installed and cannot upgrade it. If you’re 
one of these readers, don’t worry — you can still do almost every exercise in this book. Here’s how: 

* The exercises in chapters 3 through 9 the first two labs do not require Windows 8 at all. You’ll even be able to 
do them using Visual Studio 2010 (and even 2008), although the screenshots may differ a bit from what you see. 

★ For the rest of the book, you’ll need to build Windows Presentation Foundation (WPF) desktop 
apps instead of Windows 8 apps. We’ve put together a PDF that you can download from the Head First Labs 
website {http://headfirstlabs. com/hfcsharp) to help you out with this. Flip to leftover #11 in the appendix to learn more. 
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Read me 

This is a learning experience, not a reference book. We deliberately stripped out 
everything that might get in the way of learning whatever it is we’re working on at 
that point in the book. And the first time through, you need to begin at the beginning, 
because the book makes assumptions about what you’ve already seen and learned. 


The activities are NOT optional. 

The puzzles and activities are not add-ons; they’re part of the core content of the book. 
Some of them are to help with memory, some for understanding, and some to help you 
apply what you’ve learned. Don y t skip the written problems. The pool puzzles are 
the only things you don’t have to do, but they’re good for giving your brain a chance to 
think about twisty little logic puzzles. 


wakc W 吵 

-to o 



The redundancy is intentional and important. 

One distinct difference in a Head First book is that we want you to really get it. And we 
want you to finish the book remembering what you’ve learned. Most reference books 
don’t have retention and recall as a goal, but this book is about learnings so you’ll see 
some of the same concepts come up more than once. 




c^^rpen your pencil 


Do all the exercises! 

The one big assumption that we made when we wrote this book is that you want to 
learn how to program in C#. So we know you want to get your hands dirty right away, 
and dig right into the code. We gave you a lot of opportunities to sharpen your skills 

by putting exercises in every chapter. We’ve labeled some of them 4 T)o tfcis!” 一 when 
you see that, it means that we’ll walk you through all of the steps to solve a particular 
problem. But when you see the Exercise logo with the running shoes, then we’ve left 
a big portion of the problem up to you to solve, and we gave you the solution that we 
came up with. Don’t be afraid to peek at the solution —— it’s not cheating! But you’ll 
learn the most if you try to solve the problem first. 



P^ ivi ^ ics with ihe 

shoe) loao 

1 ,p ^ youVc scH 。吣 

about Icav-hihg CH=. 


We’ve also placed all the exercise solutions 5 source code on the web so you can download 
it. You’ll find it at http : / / www. headfirstlabs . com/books/hf esharp/ 


The “Brain Power” questions don’t have answers. 


For some of them, there is no right answer, and for others, part of the learning 
experience of the Brain Power activities is for you to decide if and when your answers 
are right. In some of the Brain Power questions you will find hints to point you in the 
right direction. 


7 ou sec Pool P^ic 

七 at 七 Wit/ k ay>d ^ 

7 ou (WUkc W 切㈣ M ou 

Ly：i I«kc c 舳伏 . 
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The technical review team 


Lisa KclUcv 



从 *7 HaliA 




Technical Reviewers: 



h 



aHs Bu 叶 OWs 


pavid Stcv-rm^ 



No-t pidWcd (but jus-t 
as awesome av-c -the 
v-cvicv/cv-s -Pvorw pv-evious 
editions )： Joe Albahavi, 
Jay Hilyavd, Aaya^ 

Thcodo\rc, Pdcv- 
Ritdhic, Bill Mciiclski 
A^dy Ra\rkc\r, l/Vay^c 
Bv-ad^cy, Dave /Vluv-dodh, 
Bv-idjc-tic Julie 
La^dcv-s, Nidk Paldmo, 
David Sicv-lmg. Special 
■thanks -to \rcadcv- AI 如 
Ouellette and ouv* othev- 


v-cadcv-s y/ho let us 
k^ow dbou^t issues -tha-t 


slipped "thv-oujh 6^C (o\ 
七 he -riv-s-t a^d sedo^d 


editions. 


The book you’re reading has very few errors in it, and give a lot of credit for its high quality to some great technical 
reviewers. We’re really grateful for the work that they did for this book — we would have gone to press with errors 
(including one or two big ones) had it not been for the most kick-ass review team EVER.... 


First of all, we really want to thank Lisa Kellner — this is our ninth (!) book that she’s reviewed for us, and she made a 
huge difference in the readability of the final product. Thanks, Lisa! And special thanks to Chris Burrows, Rebeca 
Dunn-Krahn, and David Sterling for their enormous amount of technical guidance, and to Joe Albahari and Jon 
Skeet for their really careful and thoughtful review of the first edition, and Nick Paladino who did the same for the 
second edition. 

Chris Burrows is a developer at Microsoft on the G# Compiler team who focused on design and implementation of 
language features in G# 4.0, most notably dynamic. 

Rebeca Dunn-Krahn is a founding partner at Semaphore Solutions, a custom software shop in Victoria, Canada, 
that specializes in .NET applications. She lives in Victoria with her husband Tobias, her children, Sophia and Sebastian, 
a cat, and three chickens. 

David Sterling has worked on the Visual G# Compiler team for nearly three years. 

Johnny Halife is a Chief Architect & Co-Founder of Mural.ly (http://murally.com)^ a web start-up that allows people 
to create murals: collecting any content inside them and organizing it in a flexible and organic way in one big space. 
Johnny’s a specialist on cloud and high-scalability solutions. He’s also a passionate runner and sports fan. 
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1 st^rt t>u!lc[!ng With c# 

Build something cool ， fast! 



EBADY 
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M 


A 


MU> 12lt>e! 


Want to build great apps really fast? 

With C#, you’ve got a great programming language and a valuable tool at 
your fingertips. With the Visual Studio IDE, you’ll never have to spend hours 
writing obscure code to get a button working again. Even better, you’ll be able 
to build really cool software, rather than remembering which bit of code was 
for the name of a button, and which one was for its label. Sound appealing? 
Turn the page, and let’s get programming. 


this is a new chapter 























c# makes it easy 


Why you should Icarw C # 

C# and the Visual Studio IDE make it easy for you to get to the business 
of writing code, and writing it fast. When you’re working with C#, the 
IDE is your best friend and constant companion. 


Here's what the IPE automates for you. 

Every time you want to get started writing a program, or 
just putting a button on a page, your program needs a 
whole bunch of repetitive code. 


usS |S ： Co^cUon3. r e rl c ； 
^elpare'^ew^rogra, 

static class Program 

{ //// SHfifentry point for t,e application 

III </summary> 

MainO 


ic void Mam() j 

Application.EnableVisualStyles^^ r ， ngDefault (false), 


What you get with Visual Studio and C # .. 

With a language like C#, tuned for Windows 
programming, and the Visual Studio IDE, you can focus 
on what your program is supposed to do immediately: 


r 

如 Ua，^ c t ^ OVA ost 

todc -ost 

tasks. 


Visv!^ 


NET Framework 
solutions 
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The |P£— ov Visual Studio 
Development is 3)^ 
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pvoyam that helps you cdi*t youv Codt) 
youv- -Piles, a^d submit youv- affs 
■to the W\y\Ao^js £*to\rc. 


private void 了 

{ ^nitializeComponentO 
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start building with c# 


C # awd the Visual Studio IPE make 
lots of things easy 

When you use C# and Visual Studio, you get all of 
these great features, without having to do any extra 
work. Together, they let you: 


Build an application, FAST. Creating programs in C# is a snap. The 
language is flexible and easy to learn, and the Visual Studio IDE does a lot of 
work for you automatically. You can leave mundane coding tasks to the IDE 
and focus on what your code should accomplish. 


❹ 


❺ 


o 


Design a great-looking user interface. The Visual Designer in the 
Visual Studio IDE is one of the easiest-to-use design tools out there. It 
does so much for you that you’ll find that creating user interfaces for your 
programs is one of the most satisfying parts of developing a C# application. 
You can build full-featured professional programs without having to spend 
hours writing a graphical user interface entirely from scratch. 


Build visually stunning programs. When you combine C# with 
XAML, the visual markup language for designing user interfaces, you’re 
using one of the most effective tools around for creating visual programs... 
and you’ll use it to build software that looks as great as it acts. 


Focus on solving your REAL problems. The IDE does a lot for you, but you 
are still in control of what you build with C#. The IDE lets you just focus on your 
program, your work (or fun!), and your users. It handles all the grunt work for you: 

* Keeping track of all your projects 

* Making it easy to edit your project’s code 

* Keeping track of your project’s graphics, audio, icons, and other resources 

* Helping you manage and interact with your data 


All this means you’ll have all the time you would’ve spent doing this routine 
programming to put into building and sharing killer apps. 


YouVc *to see 


you 




let’s get started 


What you do iw Visual Studio. 


|^ 7 ou do^-t see tWis you rn—Ue 

Visual Studio tO\tU lA/mdoy/s Vtsk^ YouH 
Yittd -to t%\i *t^a-t IPt a^d lawA Visual Studio 
t^vess ZOI2- -for IA/*mdoy/s 8. 



Go ahead and start up Visual Studio for Windows 8, if you haven’t already. Skip over the start page and select New 
Project from the File menu. There are several project types to choose from. Expand Visual C# and Windows 
Store, and select Blank App (XAML). The IDE will create a folder called Visual Studio 2012 in your Documents folder, 
and put your applications in a Projects folder under it (you can use the Location box to change this). 




Things may 
look a bit 
different in 
your IDE. 


This is what the New 
Project window looks 
like in Visual Studio for 
Windows 8 Express 
Edition. If you’re using 
the Professional or Team 
Foundation edition, it 
might be a bit different But 
don’t worry, everything still 
works exactly the same. 


What Visual Studio does for you.. 



As soon as you save the project, the IDE creates a bunch of files, including 
Main Page, xaml, MainPage.Xaml.cs ， and App. xaml. cs, when you create a new 
project. It adds these to the Solution Explorer window, and by default, puts 
those files in the Projects \Appl \Appl folder. 

TWis -file do^*ba*ms 


Codt i\\ai dc-f mcs i\\t usev 
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MainPage.xaml 




MainPage.Xaml.es 



4 Chapter 1 


Visual Siudio Creates all o-f 

•these -files au-tomati^ally- It 
several othev* -Piles as wcllf You set 
them m the Solution E^plo\rcv v/mdov/. 


: suirc that you save you 浐 pvojcd 
or\ as you dv-catc it by sdcdtmg 
All -Pv-orw -the File wChu — 七 hat’ll 


Make suve thai you save youv- pvojcdi 

dS SOOY\ 

Save 

save dll <^f the p\rojcd*t -files out *to 
the -Poldcv-. I-P you select Save, it jus 七 
s3vcs o^c youVc v/o\rkm^ oy\. 


This «fi| e doh-taihs -the C# 

純祕 — he “ he 

VP is buhdhcd oy Ircsumcd. 



App.xaml.es 
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c^rp 


en your pencil 

Just a couple more steps and your screen will match the picture below. First, make sure you open 
the Toolbox and Error List windows by choosing them from the View menu. Next, select the Light 
color theme from the Options menu. You should be able to figure out the purpose of many of 
these windows and files based on what you already know. Then, in each of the blanks, try to fill in 
an annotation saying what that part of the IDE does. We’ve done one to get you started. See if you 
can guess what all of these things are for. 


This ioolbav has 

bu-fc-fcohs -tha-t 
a Pply h> what 

you duinrehtly 
do ^ ih the IDB. 
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FILE EDIT VIEW PROJECT BUILD DEBUG TEAM DESIGN FORMAT IOOLS STORE TEST WINDOW HELP 
O ▼ iQ £1 U ► Local Machine - Debug * Any CPU ▼ ; 

o* Toolbox 

n 

3 Search Toolbox 


Quick Launch (Ctrl+Q) 


P 


blovm up "tWis 
y/'mdoy/ bcloy/ so you 
have move V-oom. 


▼早 X MainPage.xaml -o X App.xaml.es 


I Common XAML Controls 
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Button 
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CaptureElement 
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ComboBox 
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ContentControl 
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ContentPresenter 
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FlipView 

6 

Frame 

::: 

Grid 


GridView 

固 

HyperlinkButton 


Image 

<> 

ItemsControl 

<> 

ItemsPresenter 

Toolbox 

: Device 


This item does not support 



The dcsi^cv ： lets you edit 

■the USC\T . by.. 

d.o^"tv*ols o^*to i*t- 



Solution Explorer 


fS T 0 - # W ff to 

Search Solution Explorer [Ctrl+;] 

Solution 'Appl 1 [1 project] 

J |c§ Appl 

> ^ Properties 

> References 
Assets 
Common 


We switched to the Light color 
theme because it’s easier 
to see light screenshots in 
a book. If you like it, pick 
“Options...” from the Tools 
menu, expand Environment, 
and click on General to change 
it (feel free to change back). 


> n App.xaml 

p3 Ap p 1 _T em p o ra ryKey . pfe 


Mair#age.xamJ 


ll Package, appxmanifest 
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know your ide 


c^terpen your pencil 

巧 ioolba^r has butUs 

that apply io wh ^ youVe 
^unrehily doihj i h /pg 


We’ve filled in the annotations about the different sections of the Visual 
Studio C# IDE. You may have some different things written down, but you 
should have been able to figure out the basics of what each window and 
section of the IDE is used for. 
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FILE EDIT VIEW PROJECT BUILD DEBUG TEAM DESIGN FORMAT IOOLS 
O ▼ iQ £1 Ui ► Local Machine - Debug Any CPU 

o 7 Toolbox ▼ ¥ X MainPage.xaml -o X App.xaml.cs 

3 Search Toolbox P ， 

n 

a Common XAML Controls ▲ 

O 

5- ^ Pointer 


Quick Launch (Ctrl+Q) 


P 


n x 


TEST WINDOW HELP 


TVliS IS 
-toolbo%. I*t 
lids d o-f 

visual torrbroU 
you 

ov\bo youv- 


U Border 
Button 

[71 CheckBox 
^ ComboBox 
FlipView 
:::Grid 

GridView 
0 Image 
国 ListView 
O RadioButton 

□ Rectangle 
圓 StackPanel 
u TextBlock 
M T extBox 

^ All XAML Controls 
^ Pointer 
反 ] AppBar 
H Border 
Button 

□ Canvas 

<> CaptureElement 
f71 CheckBox 
^ ComboBox 

ContentControl 
|p ContentPresenter 
O Ellipse 
# FlipView 
1^1 Frame 
:::Grid 
ji ： GridView 


This item does not 
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t! IDE ^ icd ^ 

^ j … ppw So(u£ioh 

dh °7i ^ 

卜 。，上 . 


Solution Explorer 


T © ▼在 Ci 商 

Search Solution Explorer (Ctrl-*-;) 

Solution 'Appl' (1 project) 
a @ Appl 

> A Properties 

> References 

> 国 Assets 

> Common 

> D App_xaml 
|E1 App1_TemporaryKey.pfx 

WMZ 

tig] Package.appxmanifest 


▼ 

ii <> a 




P- 


D 


38.87% ▼ :S: B5 |^1 ^ 

Cl Design ti ED XAML (H 
S<Page 

x: Class: "Appl.MainPage" 

xinlns="http: //schemas . microsoft . com/winfx^2006 / xaml/presentation" 
xinlns : x="http://schemas.microsoft. com/wj^fx/2006/xaml" 
xmlns :local='*using:Appl" 

xmlns : d="http : //schemas . microsoft . coj|fexpression/blend/2008" 
xinlns :mc="http: //schemas . openxmlforj^ts . org/markup-compatibility/2006" 
me : Ignorable="d"> 

<Grid Background="{StaticResour^ ApplicationPageBackgroundThemeBrush}"> 


Search Error List 



HyperlinkButton 
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Image 


<> 

ItemsControl 


<> 

ItemsPresenter 

▼ , 

Toolbox 

Device 

Error Lmt 
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3utput 


File 
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Colu.. 


▲ Project ▲ 


l-p vou doh*t see *thc Error Lis*t or 

/ Advanced 

"foolbo%, dhoose -fvom V\t^ 


SQlution Explorer 


T © ▼ # C3 ® 圖 

Search Solution Explorer [Ctrl+v] 

Solution 'Appl 1 [1 project] 

j 回 Appl 

> 3* Properties 

> References 
篇 Assets 
_ Common 

> ^ App.xaml 
p3 Ap p 1 _ T em p □ ra ryKey. pfe 


<> ^ 


P- 




The dcsi^iniCV ； Jets ^/0\A edit. 

"the usc\T by. 

do^"tv*oU o^*to i"t* 


Properties ▼早 

MainPage.xaml File Properties 

[a];* a 

曰 Advanced 

Build Action Page 

Copy to Output Director Do not copy 
Custom Tool MSBuild:Compile 

Custom Tool Namespac 
日 Misc 

File Name MainPage.xaml 

Full Path C:\Users\Public\Documents\Vlual S 


TWis Wmdo>w 
sW 

selected 


See this little 
pushpin icon? 

If you click it, 
you can turn 
auto-hide on or 
off. The Toolbox 
window has 
auto-hide turned 
on by default. 


ih 士 he 伽 . 



MainPaige.xaml 


ll Package.appxmanifest 
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theretare no o 

Dumb Questions 


start building with c# 


So if the IDE writes all this code 
for me, is learning C# just a matter of 
learning how to use the IDE? 


You said something about 
combining C# and XAML. What is XAML, 
and how does it combine with C#? 


No. The IDE is great at automatically 
generating some code for you, but it can 
only do so much. There are some things it’s 
really good at, like setting up good starting 
points for you, and automatically changing 
properties of controls on your forms. But 
the hard part of programming—figuring out 
what your program needs to do and making 


XAML (the X is pronounced like Z, and 
it rhymes with “camel”）is a markup language 
that you’ll use to build your user interfaces for 
your full-page Windows Store apps. XAML is 
based on XML (which you’ll also learn about 
later in the book), so if you’ve ever worked 
with HTML you have a head start. Here’s an 
example of a XAML tag to draw a gray ellipse: 


Visual Stuctio will 
generate cocte 


it do it—is something that no IDE can do 
for you. Even though the Visual Studio IDE 
is one of the most advanced development 
environments out there, it can only go so far. 
It’s you— not the IDE—who writes the code 
that actually does the work. 

What if the IDE creates code I don’t 
want in my project? 

You can change it. The IDE is set up to 
create code based on the way the element 
you dragged or added is most commonly 
used. But sometimes that’s not exactly what 
you wanted. Everything the IDE does for 
you—every line of code it creates, every file 
it adds—can be changed, either manually by 
editing the files directly or through an easy- 
to-use interface in the IDE. 

Is it OK that I downloaded and 
installed Visual Studio Express? Or do 
I need to use one of the versions of 
Visual Studio that isn’t free in order to do 
everything in this book? 

There’s nothing in this book that you 
can’t do with the free version of Visual Studio 
(which you can download from Microsoft’s 
website). The main differences between 
Express and the other editions aren’t going 
to get in the way of writing C# and creating 
fully functional, complete applications. 


〈Ellipse Fill="Gray" 
Height= M 100" Width= n 75 
/> 


You can tell that that’s a tag because it starts 
with a < followed by a word (“Ellipse ”)， 
which makes it a start tag. This particular 
Ellipse tag has three properties: one to 
set its fill color to gray, and two to set its height 
and width. This tag ends with />, but some 
XAML tags can contain other tags. We can 
turn this tag into a container tag by replacing 
/> with a >, adding other tags (which can 
also contain additional tags), and closing it 
with an end tag that looks like this: 
</Ellipse>. You’ll learn a lot more 
about how XAML works and the different XAML 
tags throughout the book. 

l，m looking at the IDE right now, 
but my screen doesn’t look like yoursMt’s 
missing some of the windows, and others 
are in the wrong place. What gives? 


you can use as a 
starting point lor 
your applications. 

Making sure tke 
app does wkat 
it’s supposed to 
cto is entirely up 
to you. 


If you click on the Reset Window 
Layout command under the Window menu, 
the IDE will restore the default window layout 
for you. Then you can use the View—Other 
Windows menu to make your screen look 
just like the ones in this chapter. 



you are here 



if only humans weren J t so delicous 


Aliens attack! 


Well, there’s a surprise: vicious aliens have launched a full-scale attack 
on planet Earth, abducting humans for their nefarious and unspeakable 
gastronomical experiments. Didn’t see that coming! 






0 


O 


^ ^ Mnim, 

、 tastykramns!J 




\A\\ o\\\ 
av-c bcam'rnj 


s 


、叫叶 
Ko*t jood! 









start building with c# 


Only you can help save the Earth 

The last hopes of humanity rest on your shoulders! The 
people of planet Earth need you to build an awesome C# 
app to coordinate their escape from the alien menace. Are 
you up to the challenge? 



Move ^v\d mov-c evil aliens 
y/'ill ^ill uf l-f 

you dv*d^ youv m*to 

OY\t, OVCV-, 



D\rag the m*to the 
tav-yt bc-fov-c the timev- a*t the 

bottom of *thc \rui^s out- 


〆 


□ 



Do^i d\rag 
youv hurvtdh 
"too <^uidkly oy 
you’ll lose him. 



Our greatest kuman scientific 
minds kave inventect protective 
interctimensional ctiamonct-skapect 
portals to protect tke liuman race. 



It’S U P to YOU to SAVE THE 

ffUMAMS hy guicting tkem saiely 
to tkeir target portals. 



you are here ► 
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Here’s the structure of the app we’re going to create: 


一 Tl)e 岍咖 ^ ojs 


XAML Main Page 
and Containers 


Voull lav out ^ ?ay 

—a —. 〜 ^ ： 11 

-take c 

oU:— 』“ SC a Cavwas 

^ov* 


Windows Ul 
Controls 


TV app uses these ^Ohtv-ols 

Ay^" " t ° -the -b\rgc-t t\\t 

^ is digged to a^d the 

匕 ouhtdovm "tirwev- display. 


The lav-jet 
-timer -the 
Pv-ojvcssBav-^s 
properties *to 
see i-f the playc 
v-a^ ou*t o( *tirwC- 


Ea 匕 li hunrtdh "that 

the flayev- has 
■to save is dvawh 

usihg a Sta^kRahd, 
which doivt^ihs 
如 ellipse ay\d a 
v-c^tahglc. 


here’s your goal 

Here's what you're going to build 

You’re going to need an application with a graphical user 
interface, objects to make the game work, and an executable to 
run. It sounds like a lot of work, but you’ll build all of this over 
the rest of the chapter, and by the end you’ll have a pretty good 
handle on how to use the IDE to design a page and add C# code. 


6 ^RAB A CUP O? 

CO??^ AND SBTTUB INi 
Y^U^B AB^UT JO RBAUUY PUT 
TNB 工此 THR^Ud^H ITS PA 6 BS ； 
AND BUIUD A PRBTTY COOL, 


By {\\t tv\A o^c 
匕 hap 七饮 , you’ll k 灼 oy/ youv 

y/dy avound *tV^ IPt ； 

3v)d iiave a ^ood head 
s*tav*t oy\ y/vitm^ Codt- 
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You’ll be building an app with two different 
kinds of code. First you’ll design the 
user interface using XAML (Extensible 
Application Markup Language), a really 
flexible design language. Then you’ll 
add C# code to make the game actually 
work. You’ll learn a lot more about XAML 
throughout the second half of the book. 


Youll WH^ c# dode ihai 

Rubies ih e ^o^ols 

Y/oy-k. 


start building with c# 

’七 S h0 七 ^ huSual f OY， 匕气士 \rs m 扣 i 夂铋 be vuhh'ma 

〒七加 as old ^ 1001. W\ih this 

rPh you still do the fvojcdts m the book. 

o 


No Windows 8? No problem. 

The first two chapters and the last 
half of this book have many projects 
that are built with Visual Studio 2012 
for Windows 8, but many readers aren’t running Windows 
8 yet. Luckily, most of the Windows Store apps in this 
book can also be built using Windows Presentation 
Foundation (WPF), which is compatible with earlier 
operating systems. You can download a free PDF with 
details and instructions from http:/ / www. headfirstlabs. com/ 
hfesharp ••Slip to leftover #11 in the appendix for 
more information. 



C 斿 Code 



PeploymcMt 

Package 



Ene^ S 



/Tick event handle^ 


You’ll use two 
tirwC\rs -fco sdd 

C^ics a^d cv\d the 
i-P the playev- 
IfUhS out <^P time. 



StartGame() 
AddEnemy() 
AnimateEnemyO 
EndTheGame() 





Program 

file 



youm app is wo^kiha 

y° u ^ p^ka 9 c ii U p 
f ^ be uploaded 
㈧ hdows SW 

^ selli h a 

ahd dis^ibuiihj apps. 
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fill in the blanks 


Start with a blank application 

Every great app starts with a new project. Choose New Project from the File 
menu. Make sure you have Visual C#^Window Store selected and choose 

Blank App (XAML) as the project type. Type Save the Humans as 

the project name. 



n y ⑽ todt -filenames do〆 七⑶ d m 
you may have addidc^tally dvea-ted d 
JavaSdv-ipi, l/isual Basit, o\r \/isual C++ 

p 浐亨 am. /ou dan *Pi 乂 -this by dlosmg -the 
solution and ovcv. you y /如七 

■fco keep "the pv*ojcd*t w Savc "the 
Humans, you’ll heed *fco delete "the 
previous p\rojcdi -Poldcv-. 


① 


Your starting point is the Designer window. Double-click on MainPage.xaml in the Solution 
Explorer to bring it up. Find the zoom drop-down in the lower-left corner of the designer and 
choose “Fit all” to zoom it out. 


4 Save the Humans - Microsoft Visual Studio Express 2012 for Windows 8 

FILE EDIT VIEW PROJECT BUILD DEBUG TEAM DESIGN FORMAT TOOLS STORE TEST WINDOW HELP 
JQgjyiJil 1 ^ ^ ^ ► Local Machine ▼ Debug Any CPU ▼ ^3 _ ； 

o 


Quick Launch (Ctrl+Q) 


fi 


n 


x 


I App.xaml.cs 


彐 

n> 

o 

I 


o_ 


The dcsi^cv- |hows 
you a fv-eview !>-(* 
i\\t i\\ai 
youVc y/ov*km^ 

I 七 looks like a 
blank wi*th 
a default blatk 
badk^\rou)r>d- 




•con/winfx/2006/xam 


53.65% 

Cl Design tT" 

目 〈Page 

x:Class="Save_the 一 Humans.MainPage" 
xmlns='*http: //schemas, microsoft. 

xmlns : x="http://schemas.microsoft.com/winfx/2006/xaml.' 
xmlns : local="using: Save_the_Humans M 

xmlns : d="http://schemas.microsoft.cofn/expression/blend/2008" 
xmlns : me ="http://schemas.openxmlformats.org/markup-compatibility/2006" 
me : Ignorable="d"> 

<Grid Background="{StaticResource ApplicationPageBackgroundThemeBrush} M > 


</Grid> 

</Page> 






Use these three buttons to turn on the 
grid lines, turn on snapping (which 
automatically lines up your controls to 
each other), and turn on snapping to grid 
lines (which aligns them with the grid). 


100 % 
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ypu are Jiere! 


XAML Main Page 
and Containers 


Windows Ul 
Controls 


C* Code 



start building with c# 



The bottom half of the Designer window shows you the XAML 
code. It turns out your “blank” page isn’t blank at all —— it contains 
a XAML grid. The grid works a lot like a table in an HTML 
page or Word document. We’ll use it to lay out our pages in a way 
that lets them grow or shrink to different screen sizes and shapes. 


Y^ou da 内 )<AML- 乙 0 dc 

(or -the bla^k yr\A IDE 

^c^cva*ted -Pov- you. youv eyes 
i*t—well add some doluwms and 
vov/s m a 


53.65% - 
□ Design 




U 


□ XAML 


B<Page 

x:;<Ilass= l, Save_the_Hujnans.(MainPage 1 " 

son 1 n s = ■■' htt p;//sch ema s.micro soft „ c om/wi nfx/2& & 6 / xa ml/ p re s e nt at io n ■■ 
xmlns : x= ir http ^ / /schemas .microsoft. com/winfx/Kami 1 ’ 
xmlns : local: ■■ using s Save 一 the 一 Humans 1 ’ 

xmlns id=" http:;"schemas jmicrosoft.com/expression/blend/2&@S IF 
xinlns ： fnc=" http ://schemas.openjcmlformats.org/markup-compatibility/2^06 1 
me :IgnorabIe= l, d 1, > 


E 


<Grid^Background= 1, {StaticResource ApplicationPageBackgroundTheineBrush} 


> 


</Grid> 

</Page> 


These a\rc *thc a^d dlos'm^ -ta^s -Pov- a yid -tha-t 

乙 orvta’ms dorrbrols. W\\tv\ you add vov/s, artd dorrtvols 

"to 七 he yid, 七 he Codt (or -them v/ill o^o brtv/cc^ -these ope 灼 mg 
dnd dlos'm^ -tajs. 


100 % 



LOOK\^ lO L 5 A 12 N K/PF? LOOK N^> FUETHBlSi 


Most of the Windows Store apps in this book can be built with WPF (Windows 
Presentation Foundation), which is compatible with Windows 7 and earlier operating 
systems. Download the free WPF guide to Head First C# PDF from our website: 
http://headfirstlabs.com/hfcsharp (see leftover #11 in the appendix for more details) 


Tliis port P? the project tas steps numbered (T) ±9 (5). 
Flip tfce pcige t9 keep going! 
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get a running start 


② 


Your page is going to need a title, right? And it’ll need margins, too. You 
can do this all by hand with XAML, but there’s an easier way to get your 
app to look like a normal Windows Store app. 

Go to the Solution Explorer window and find ^ n MainPage.xaml. Right- 
click on it and choose Delete to delete the MainPage.xaml page: 


Solution Explorer 


▼© ▼ Q IS ® <> > PJ 

Search Solution Explorer (Ctrl*;) fi 

53 Solution ’App4. (1 project) 

^ ® Save the Humans 


Over the next few pages 
you’ll explore a lot of 
different features in 
the Visual Studio IDE ， 
because we’ll be using 
the IDE as a powerful 
tool for learning and 
teaching. You’ll use the 
IDE throughout the book 
to explore C#. That’s a 
really effective way to 
get it into your brain! 


^ A Properties 

> •. References 

> _ Assets 

^ _ Common 
^ o App.xaml 

® App4_TemporaryKey,pfx 


■ MainPage.xaml 


t Package.appxmanifest 


1 ( you sec -the 

Solution E><.plo\rcv-, you 灼 
use "the \/ic>w {jo opCh 
it 乙扣 also \rcsct the 

IDE’s y/'mdoy/ layout usmj 
"the iV'mdov/ 


Open 

Open With … 

Open in Blend". 

<> View Code 
[# View Designer 
Scope to This 

^ New Solution Explorer View 
Exclude From Project 
Run Custom Tool 
<K> Cut 
dl Copy 
X Delete 
X Rename 
A Properties 


Ctrl+Alt+0 

Shift+F7 


Ctrl+X 

Ctrl+C 

Del 

F2 


Wken you start 
a Winctows Store 


app ， you’ll often 
replace tke main 
page witli one 
ol tke templates 
tkat Visual 
Studio provides. 


③ 



|*P you those d when you 

youv- youll see -tha-t 

name ms-tcad o( Yl Savc -the HumaW m 

"the Solution E)Cplov-cv-. 

Now you’ll need to replace the main page. Go back to the Solution Explorer and 
right-click on a n§ Save the Humans (it should be the second item in the 
Solution Explorer) to select the project. Then choose Add—New Item... from 
the menu: 


Add 

► □ 

New Item... 

Ctrl+Shift+A 

Add Reference... 


Existing Item... 

Shift+Alt+A 

Add Service Reference... 


New Folder 


Store 

m m 鼴 ■ 

► v 

Class... 

Shift+Alt+C 
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start building with c# 


The IDE will pop up the Add New Item window for your project. Choose Basic Page and give it the name 
MainPage.xaml. Then click the Add button to add the replacement page to your project. 



you v-cpladc 
Ala … Rayol y/rth 
the Basid Pajc 
item, -the IDE v\ttds 
*to add dddi'tio^al 


-files. Rebuild'm^ 
the solution bv'm^s 
cvcv-yth'mj up to 
date so it 乙扣 


display the page m 
the dcsijhcv-. 



The IDE will prompt you to add missin g files —— choose Yes to add them. Wait for the designer to finish loading. It 
might display either Invalid Markup or Build the Project to update Design view. . Choose Rebuild Solution from the 
Build menu to bring the IDE’s Designer window up to date. Now you’re ready to roll! 


Let’s explore your newly added MainPage.xaml file. Scroll through the XAML pane in the designer window until you 
find this XAML code. This is the grid you’ll use as the basis for your program: 


$8.22% - tit Ml |2 4 
c Design h □ XAML Q 
<! -- 

This grid acts as a root panel for the page that defimes two rows : 
* Row © contains the back button and page title 


□_ps 


赢 


* Row 1 coriitains the rest of the page layout 

r<GrlyStyle- ,!, {StatlcResource LayoutfiootStyle}"> 
、 - ^?Grid.RowDefinitions> 

<RowDefiriition Helght= IH 140"/> 
<RowDefinition Height= n!|£ "/> 

</Grid>RowDefinitions> 


You ll use IPt b> lay out 
Youv ap\> by yr\A- 


1 


<[ -- Back button «nd page title --> 

<Cjrid> 

<Grid ( ColumnDefinitions > 

<ColumnDefinitlork Widths "Auto'7> 

<ColumnDefinitiork Width- "*'V> 

</Grid.ColumnDefinitions? 

<Euttork x : Name=" bac kButton" Cllcks^GoBack" Is Enabled^" {Binding Frame .CanCoBack^ 
<Textfilock x : Name= "pageTltle" Grid .Column="l l< Text^" {StaticResource AppName} " St 
</Grid> 


bolide how -thc^c^s a whole scpavaic yr\d, 
w’rth its ovm sta\rt*mj <^vid> and ⑶ dmg 

</ 与 v_d> tags? Thai’s 七 he pay header 
七 hal displays 七 he app This yid is 
also ^o^jamed msidc ihc v-ooi gv-id ihai 
youll be ddd'rn^ do>vbroU 


iDD % 


► 



Youv f>a^e should 
be displayed *m 
七 he dcs'i^cv. 

|<p rt isr / 七， 
doublc-dl'idk oy \ 
Ma'mPa^c^aml 
•m *tV>c Solution 
£%flovcv. 
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not so blank after all 


④ 


Your app will be a grid with two rows and three columns (plus the 
header row that came with the blank page template), with one big cell 
in the middle that will contain the play area. Start defining rows by 
hovering over the border until a line and triangle appear: 


Save the Humans - MainPage.xaml 

^_ 


|-f you d 。 〆 七 see 

I 十 0 

air>d alor>5 
七 he bov-dev 
youv- t\\tk 
outside 七 he 


il 

S © My Application 

1 






剛 

1 


i 

I 






!I 



ttovcv- ovcv- -the 
bovdev- o( yid 

uirrtil 為的 ova 的 

■tv-ia^glc d^dl I'me 
appeav. 


… 七 hen dlidk {o 
^v-ca*tc a bo'tfcom 

vow \ y \ yid. 


Laying out tke page using a 
griefs columns and rows allows 
your app to automatically 
adjust to tke display. 



A*P*tcv* 七 he vow is added ； 
Imc will 

•to blue by\A youll see 
*thc vow hei^ivt m *tKc 
bov-dev-. The hei^ivt 
*thc Ccy\{,cv v-ow will 
-Pvom I 决 *to a 
lav*^cv* r^umbev* -folIov/cd 
by a s*tav- 


therei are nQ 

Dumb Questi 9 ns 


Windows Store 
apps need to 
look rigkt on 
any screen, 
from tablets 
to laptops to 
giant monitors, 
in portrait or 
landscape. 



But it looks like I already have many rows and 
and columns in the grid. What are those gray lines? 

The gray lines were just Visual Studio giving you a 
grid of guidelines to help you lay your controls out evenly 
on the page. You can turn them on and off with the i!L 
button. None of the lines you see in the designer show up 
when you run the app outside of Visual Studio. But when 
you clicked and created a new row, you actually altered 
the XAML, which will change the way the app behaves 
when it’s compiled and executed. 


Wait a minute. I wanted to learn about C#. Why 
am I spending all this time learning about XAML? 

Because Windows Store apps built in C# almost 
always start with a user interface that’s designed in XAML. 
That’s also why Visual Studio has such a good XAML 
editor—to give you the tools you need to build stunning 
user interfaces. Throughout this book, you’ll learn how 
to build two other types of programs with C#, desktop 
applications and console applications, neither of which 
use XAML. Seeing all three of these will give you a deeper 
understanding of programming with C#. 
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start building with c# 


Do the same thing along the top border of the page —— except this time create two columns, a small one 
on the lefthand side and another small one on the righthand side. Don’t worry about the row heights 
or column widths —— they’ll vary depending on where you click. We’ll fix them in a minute. 


Po^*t wovvy i-P youv* 
vow hei^vts ov 
widths ave 
you’ll -Pi% oy\ 

fay. 



When you’re done, look in the XAML window and go back to the same grid from the previous page. 
Now the column widths and row heights match the numbers on the top and side of your page. 


r * Design ti eXAML ■ 


曰 

I 

曰 


曰 


100 % 


<! 


This grid acts as a root panel for the page that defines two rows : 

* Row 0 contains the back button and page title 

* Row 1 contains the rest of the page layout 


> 


<Grid Sty le="{StaticResource LayoutRootStyle} 
<Grid.ColumnDefinitions> 

〈ColumnDefinition Ulidt(^="165* ,, /> 
<ColumnDefinition 


> 


Ulidth= ,, iy^5^ ,, /> 

〈ColumnDefinition Width: "166 *"/〉 
</Grid.ColumnDefinitions > 

<Grid.RowDefinitions > 

<RowDefinition Height="140"/> 
〈RowDefinition Height="125*"/> 
〈RowDefinition Height="32*'V> 
</Grid.RowDefinitions > 


tteire’s the y/idth the Ic-Pt dolumrt 
you dv-catcd \ y \ s-tep 弓一七 he width 
七 he v/id-th 七 ha 七 you saw m 
the dcsijhcv-. 丁 hat’s bemuse the IVB 

jchcvatcd -this )<AML Code -Pov- you. 


□HEl 

4 s 


▲ 


▼ 


► 


Your grid rows and columns are now added! 

XAML grids are container controls, which means they hold other 
controls. Grids consist of rows and columns that define cells, and 
each cell can hold other XAML controls that show buttons, text, and 
shapes. A grid is a great way to lay out a page, because you can set its 
rows and columns to resize themselves based on the size of the screen. 
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let’s size up the competition 


Setup the grid for your page 

Your app needs to be able to work on a wide range of devices, and using 
a grid is a great way to do that. You can set the rows and columns of 
a grid to a specific pixel height. But you can also use the Star setting, 
which keeps them the same size proportionally — to each other and also 
to the page —— no matter how big the display or what its orientation is. 


O SET THE WIDTH O? THE LEFT 

Hover over the number above the first column until a drop¬ 
down menu appears. Choose Pixel to change the star to a 
lock, then click on the number to change it to 160. Your 
column’s number should now look like this: 

160 a - 


O EBPBAT THE Eld&HT AMD 

THE BOTTOM 

Make the right column and the bottom row 160 by 
choosing Pixel and typing 160 into the box. 


Set your columns or rows to 
Pixel to give tkem a fixect 
wicttk or keigfkt, Tke Star 
setting lets a row or column 
grow or skrink proportionally 
to tke rest oi tke grid. Use 
tkis setting in tke designer 
to alter tke Wicttk or Height 
property in tke XAML* H 
you remove tke Wicttk or 
Heigkt property, it’s tke same 
as setting tke property to I 5 * 1 . 


W\\cv\ you 

的 umber, you modi-fy 


the jv-id—i*ts 
)<AML toAt- 



435 来 / 



o 


It’s OK if you’re not 
a pro at app 
design.. .yet. 

We’ll talk a lot more 
about what goes into designing a good 
app later on. For now, we’ll walk you 
through building this game. By the end of 
the book, you’ll understand exactly what 
all of these things do! 
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start building with c# 


o MAKE THE ^BMTBE AND ^BMTBE THE 

DEFAULT SIZE (IF THEY AE6N ， 丁 AURBADY). 

Click on the number above the center column and enter 1. Don’t use 
the drop-down (leave it Star) so it looks like the picture below. Then 
make sure to look back at the other columns to make sure the IDE 
didn’t resize them. If it did, just change them back to 160. 


XAML and C# are 
case sensitive! Make 
sure your uppercase 
and lowercase letters 
match example code. 


W\\tY\ you wtev* I 决 m*to 七 he bo%, 
IPS srts 七 he dolumy> *to "i*U 
dc-f3ul*t v/id 七 h. |七 adjust 
七 I 化 o*thcv dolum^s. |-r i*t docs, jus*t 
rtsti -them badk bo l^>0 f*i%cls. 



o \-OOK AT VOU^ XAMU COl>BL 

Click on the grid to make sure it’s selected, then look in the XAML window to see the code that you built. 

<! -- 


This grid acts as a root panel for the page that defines two rows: 

* Row 0 contains the back button and page title The <^\d > li^c ai -the -top 

* Row 1 contains the nest of the page layout mc«ihs cvcv-y-thmg -tha-t co^s 

--> a-p-tc\r i-t is pa\rt ci the yid. 

<Grid Sty le="{StaticResource LayoutRootStyle }"> 


<Grid.ColumnDefinitions> 

〈ColumnDefinition Width= ,, 160"/> 

(^ColumnDef initio^2X^ —- " 

<LolumnuetinitiorTwidth= ,, 160 ,, /> 

</Grid.ColumnDefinition s> 


IS V)OV/ d dolunr\ir> is dc-("llr>cd *(*OV d 

yid. Vou added *tKvcc tolunrms ar>d *tKv-cc v-ov/s, 
SO *thcvc avc *tKvcc Colum^Pc-f'm*itioir> ar\d 

•tKvcc Roy/Pc-f miti OY\ •tay. 


<Grid.RowDefinitions> 

<RowDefinition Height= 
< RowDefinition/> 

< RowDefinition 多 eight = 
〈 /Grid•RowDefinitionsT 


140"/> 


I 灼 a you’ll be dddi^ doh-bvols 

*to you\r J\rid, y/hidh v/ill show up 

七 he \rov/ doluwm dc*f mi*tio 灼 s. 



This h>P ^row with a height o-f I 切 pixels is 
pa\rt of the Basid Page template you added. 


Y^>u used "the ^olumh dhd Vow 
d\rop-dowhS -to set the iVidth 
Height pv*opc\rtics. 
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FILE EDIT 

o - 


MainPage.) 


3 

O 


take control of your program 

Add controls to your grid 

Ever notice how apps are full of buttons, text, pictures, progress bars, sliders, 
drop-downs, and menus? Those are called controls, and it’s time to add some 
of them to your app —— inside the cells defined by your grid’s rows and columns. 


W you SCC the 

■toolbox ih the IVB, you 
Uh opCh it usihg the 1/icw 
Use ihe fushfm io 
吓 it ^ollapsih^. 


① 


Expand the 
drag a ^ 

^arch Toolbox 

^ Pointer 
50 AppBar 
n Border 


Common ； XAML Controls 


iotton 


section of the toolbox and 
into the bottom-left cell of the grid. 

P ▼— 




<> 


Button 


Canvas 
CaptureElement 



Toolbox 


Search Tool b ok 
J Common XAML Controls 


P 




k 

Pointer 

n 

Border 

Q 

Button 


CheckBoK 


ComboBoK 


FlipView 

■■■ 

■■■ 

■■■ 

Grid 

■■■ 

备： 

GridViaw 

m 

linage 

El 

ListView 

© 

RadioButton 

□ 

Rectangle 

圓 

StackPanel 

m 

TextBlock 


T extBoK 


Then look at the bottom of the Designer window and have 
a look at the XAML tag that the IDE generated for you. 

You’ll see something like this — your margin numbers will be 
different depending on where in the cell you dragged it, and the 
properties might be in a different order. "These a^c 

ne XAML U iu buiU sia,-b 广 ^ b | 

ke, 4 % V> ^ S，3 ^ 411 幫 d b Y 心士 . 

L-><Button Content=" Button" HonizontalAlignment= ,, Left" 

Margin="60^72,0 J 0" Grid. Row="2 M VenticalAlignment= M Top"/> 


Drag a 


TextBbck 


into the lower-right cell of the grid. Your XAML will look something like this. 


See if you can figure out how it determines which row and column the controls are placed in. 


|Q 


(jl_^ m the Ulbox 广 

,_ 'i _- 诎⑶ ^ oh the TcxtBlo^k 

TextBlockf 穴’七 av~ouhd ahd 

^ - - - L thc update -the Mairgih 

propClrty i h the XAML. 


ed XAML 


< 


TextBlock Grid .Column="2" HorizontalAlignment=" Left" 

Margin="14j 8,0j0" Grid. Row="2" TextWrapping="Wrap 
Text ="TextBlock" VerticalAlignment=" Top"/> 


If you don’t see 
the toolbox, try 
clicking on the 
word “Toolbox” 
that shows up 
in the upper-left 
corner of the 
IDE. If it’s not 
there, select 
Toolbox from 
the View menu 
to make it 
appear. 


Device Toolbox 
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Wt added I'me breaks -to make -the )(ML casicv- -to 
v-cad- 匕扣 add I'me breaks -too . 今 ive it a iry! 















































start building with c# 


Next, expand the 


IProgressEar 


section of the toolbox. Drag a E3 
into the bottom-center cell, a into the bottom-right cell (make sure it’s 

below the TextBlock you already put in that cell), and a 国 into the center cell. 

Your page should now have controls on it (don’t worry if they’re placed differently than 
the picture below; we’ll fix that in a minute): 


1 ® Save the Humans 


ttevVs 七 he 
butfccm you 
added ’m s-tcp I- 

- m - I 1 - 


Start! 


you add 七 he 
Cairwas doyrbrot I 七 

looks like by\ — \ 

bo%. Wt\\ -f'i'x* 七 ha 七 ^ 

shortly. - 


Heve’s 七 he Tc^tBlodk 
dojrrbrol ^ou added m 
step Z. You dvagyd 
d Co 灼七⑶七 Coh*brol 
irrto -the same dell- 


You jus-t added 
■this^Pv-ogv-cssBav -： 


ttcv-c^s -the Co^*tc^*tCoir\*tv-ol • 
iVhat do you tlVmk i 七 docs ? —’ 


ntentControl 


You’ve got the Canvas control currently selected, since you just added it. (If not, use 
the pointer to select it again.) Look in the XAML window: 

<Canvas G^id.Colu^^n= l, l 1, Grid. Row^ 1 '! 11 Hci 「 izontalAlignnient:= 1f Left 1 ’ Height= 1l l^& 1F ... 

It’s showing you the XAML tag for the Canvas control. It starts with 〈Canvas and 
ends with / >, and between them it has properties like Grid. Column= M 1" (to put 
the Canvas in the center column) and Grid. Row= M 1" (to put it in the center row). 
Try clicking in both the grid and the XAML window to select different controls. 


72.13% - 

Ui Design 


0 : 4 - 


U 


回 XAML 


TVy dlidk'mg this button. 

I 七 bv^rn^s uf the 
Outline wmdow. you 
-f igure out hov/ *to use i*t? 
^.15y \4u’ll moV"C abou*t i*t 

m a -few fays. 


Wken you drag a 
control out ol tke 
toolbox and onto 
your page, tke 
IDE automatically 
generates XAML 

to put it wkere you 
dragged it. 
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your app’s property value is going up 


Use properties to change how the controls look 

The Visual Studio IDE gives you fine control over your controls. The Properties window 
in the IDE lets you change the look and even the behavior of the controls on your page. 



youVc ediii^ 

,use -the Escape 
kc y ^ -finish. This P 

Wo,rks oihe^r 

^ ih ihc IVB t U. 


o Change the text of the button. 

Right-click on the button control that you dragged onto the grid and choose Edit Text 
from the menu. Change the text to: Start ! and see what you did to the button’s XAML: 

< Button Co ntent= "Start! 1F Horizonta 1 Alifininent = 1,1 Left 1,1 VerticalAlijsnment= lp Top"' ... 

W\\tY\ you cd*i*t bu*t*to^, IPE 

updates *tKc C 。 灼七⑶七 pvowty … 七 he 







m 

L-- QD 

r 

■ 




Use the Name box to change the 
name of the control to startButton. 


❹ 


Properties 


Name st 


artBu 


Type Button 
Search Properties 
Arrange by: Category T 

> Brush 

> Appearance 
J Common 


tton 


f 


P 


rwiglvt 


You 

y\ttA -fco 

expand the 

Commoh 

and Layout 

sc^tiohS. 



Cite kM ode 

Release 

Content 

Start! 

Content! ransiti ons 

[Collection] 

ToolTi pSesrvice.Tool. ■ . 


DataContext 



V 

Layout 


Width 

Auto (71} 

Height 

Auto [38) 

Row 0 

□ RowS... 

Column 0 

□ Colum... 

ZlndeK 

0 

Horizontal Al ignment 

1- 

VertkalAlignment 

f rnn ii n 

Margin 

♦ 0 H 


會 0 4 



□ 


Use the Properties window to modify the button. 

Make sure the button is selected in the IDE, then look at the 
Properties window in the lower-right corner of the IDE. Use 
it to change the name of the control to startButton and 
center the control in the cell. Once you’ve got the button looking 
right, right-click on it and choose View Source to jump 
straight to the 〈 Button 〉 tag in the XAML window. 

These little s<^ua\rcs id I you i-f -the pv-opev-ty has bee 灼 

sc *t- A -filled s^uav-c means rt’s sci ； ar> erwp-ty 
s<^a\re mcahs ii's bee" Ic-Pi wi 七 h a dc-Pault value. 

W\\tY\ you used u Edi*t Tc^*t w oy\ dlidk *to 匕 

the buttons the IPE updated the Co 灼七 ⑼七 property. 


New 

□ 





Use the 


and 

II 


buttons to set the 



HorizontalAlignment and VerticalAlignment properties 
to “Center” and center the button in the cell. 


XButton 


V 


> 

> 


Text 

Transform 

Interactions 

Miscellaneous 


When you dragged the button onto the page, the IDE 
used the Margin property to place it in an exact position 
in the cel]^ Click on the square ■ and choose Reset from 
the menu to reset the margins to 0. 

ba^k -fco -the 

x:Name="startButton" 二 

Content: "Start! n 〆 look ai the xA/WL 
Grid.Row= ,, 2 M ^ ihaiyou updatcd - 
HorizontalAlignment= M Center" 
VerticalAlignment="Center"/> 
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The pv-opcv-tics may be m a ov-dev-. That’s 0 匕 ! 



























Yon are Lere! 


You can use Edit^Undo (or Ctrl-Z) to undo 
the last change. Do it several times to undo 
the last few changes. If you selected the 
wrong thing, you can choose Select None 
from the Edit menu to deselect. You can also 
hit Escape to deselect the control. If it’s 
living inside a container like a StackPanel or 
Grid, hitting Escape will select the container, 
so you may need to hit it a few times. 


❺ Change the page header text. 




XAML Main Page 


start building with c# 


Addtnemyl 


C* Code 


Peployweiit 

Package 


f Tick event handle^ 


/Tick event handle^ 


Right-click on the page header (“My Application”）and choose View Source to jump to the XAML for the 
text block. Scroll in the XAML window until you find the Text property: 


Text="{StaticResource AppName} 


Wait a minute! That’s not text that says “My Application” 一 what’s going on here? 


o 


❺ 


The Blank Page template uses a static resource called AppName for the name that it displays at the top 
of the page. Scroll to the top of the XAML code until you find a <Page. Resources〉section that has 
this XAML code in it: 

<x:String x: Key="AppName">My Application</x : String 〉 y^uv 乙 k ihr>d 

C 。 灼七⑶七 Co 灼七 ( 。 1 糾 

Replace u My Application’’ with the name of your application: 

<x:String x : Key=" AppName" >Save the Humans</x: String> 


loy/cv--v*i^h*t tt\\ 

o( y'id- 


Now you should see the correct text at the top of the page: 


Save the Humans 


<f 


Dok /七 wo\r\ry about that \>ack 
bu 七 "toh. Y^>u II lcd\rh dll dbou 七 Kow 
io use it \v\ Chaptcv- \\. Youll 
also lca\rh about statid. v-csouv-^cs. 


Update the Text Block to change its text and its style. 

Use the Edit Text right-mouse menu option to change the TextBlock so it says 
Avoid These (hit Escape to finish editing the text). Then right-click on it, choose 


the I Ed it Style 


menu item, and then choose the |Apply Resource 叫 submenu and 


and then right-click. Choose |Group Into ► from the pop-up menu, then choose 


StackPanel 


.This adds a new control to your form: a StackPanel control. You can 


select the StackPanel by clicking between the two controls. 

The StackPanel is a lot like the Grid and Canvas: its job is to hold other controls 
(it’s called a “container”)，so it’s not visible on the form. But since you dragged the 
TextBlock to the top of the cell and the ContentControl to the bottom, the IDE created 
the StackPanel so it fills up most of the cell. Click in the middle of the StackPanel 


to select it, then right-click and choose 


Reset Layout 


and 


All 


to quickly reset its 


properties, which will set its vertical and horizontal alignment to Stretch. Finally, right- 
click on the TextBox and ContentControl to reset their layouts as well. While you have 
the ContentControl selected, set its vertical and horizontal alignments to Center. 


Avoid These 


ContentCorrirol 


select SubheaderTextStyle to make its text bigger. 

Use a StackPanel to group the TextBlock and ContentControl. 

Make sure that the TextBlock is near the top of the cell, and the ContentControl is near 
the bottom. Click and drag to select both the TextBlock and ContentControl ， 


Group Into 

► 



StackPanel 


Avoid These 

ContentControl 


bo% affeavs Bro\AY\d 
^ S*tatKpair>cl i-f you 
vcv- OVCV- "l*t- 


Reset Layout ►. 



All 


■■ 


void These 

ontEntCorrtrol 

Ri^vt-didk a 灼 d 

v-cset 七 he layout 
o( -the StadkPa^cl, 

Coh 七⑶ *tCcm*brol. 
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you want your game to work, right? 




o 


Update the ProgressBar. 

Right-click on the ProgressBar in the bottom-center cell of the grid, choose the Reset 
Layout menu option, and then choose All to reset all of the properties to their default 
values. Use the Height box in the Layout section of the Properties window to set the 
Height to 20. The IDE stripped all of the layout-related properties from the XAML, 
and then added the new Height: 

<ProjEressBar Grid.Co 丄 umn=' ， l ■- Grid. Row="2 a ' HeiEht= ,, 20'V> 


Gh dlso 3 亡七 

"to 仏 C (: 

Ou-tlihc by ^hoosiha 
"the l/icw->0-th cv . 
I^Vihdows mehu. 


Turn the Canvas control into the gameplay area. 

Remember that Canvas control that you dragged into the center square? It’s hard 
to see it right now because a Canvas control is invisible when you first drag it out of 

the toolbox, but there’s an easy way to find it. Click the very small 国 button above 
the XAML window to bring up the Document Outline. Click on 
select the Canvas control. 


[Canvas] 


to 


Make sure the Canvas control is selected, then use the Name box in the 
Properties window to set the name to playArea. 

— you Aa，the ha% 
II show up as playAv-ca 
\yysicad o( CCa^as] m -the 
OutlihC wihdow. 


Background 


SI 


Editor 


圍 




O 


Document Outline 


JL pageRoot 

J D pageRoot 

im BottomAppBar 
im TopAppBar 
J ^ [Grid] 

J ^ [Grid] 

bacikButton 
S pageTitle 
startButton 
曰 [ProgressBar] 

J 貝 [StackPanel] 

S [TextBlock] 

幻 [UserContirol] 


<D £ 


<D o 
© o 
® o 
© o 
<D o 
© o 

<±5 O 

© o 

<±5 O 


[Canvas 】 


© o 


Color resources 


OY\ -tKc 

-tab, ov\ 七 he 

tolov* -foV' 

oy\ 

-Hhc vi^vtV^d *bab 3 灼 d 


E 165 
G 64 
B 23B 
A 100% 


After you’ve named the Canvas control, you can close the 
Document Outline window. Then use the 




and 


II 


buttons 


in the Properties window to set its vertical and horizontal 




^ % #FFA640EE 



alignments to Stretch, reset the margins, and click both 以 
buttons to set the Width and Height to Auto. Then set its 
Column to 0, and its ColumnSpan (next to Column) to 3. 

Finally, open the Brush section of the Properties window and 
use the H3 button to give it a gradient. Choose the starting 
and ending colors for the gradient by clicking each of the tabs 
at the bottom of the color editor and then clicking on a color. 


Chapter 1 


Controls make the game work 


Controls aren’t just for decorative touches like titles and captions. They’re central to the way your game works. 

Let’s add the controls that players will interact with when they play your game. Here’s what you’ll build next: 

You’ll ercaic a flay airca with a 」川 , 丄 L n … 扣 d you’ll use a 

yad 咖七 咖 d... you II wov*k the ^ ( | makc p^oycssBav 匕你如 Vouv . 

as y/'»dc as its ⑶加丫 | 00 k like iW\s. 





Document outline A ^you S5 also ops?c po?55tou*trc by 

dirkkmcp 十 hr%-kab o3rHhr%ulidr%o^ 十 hr*IPE. 


24 









































start building with c# 


❺ Create the enemy template. 

Your game will have a lot of enemies bouncing around the screen, and you’re going to want them to all look the 
same. Luckily, XAML gives us templates, which are an easy way to make a bunch of controls look alike. 

Next, right-click on the ContentControl in the Document Outline window. Choose Edit Template, then choose 
Create Empty. .. from the menu. Name it EnemyTemplate. The IDE will add the template to the XAML. 


YouVc w -fly*m5 bl’md” *fov • 七 Wis 

灼 c % 七 dcs'i^cv ^or!i 

display -fov- i\\t 

reflate I you add a torrbrol 
av>d sc*t so 

•l*t sKoV/S Uf. Po^*t V/OV-V-y ； you 
乙扣 alv/ays undo av>d *bry i-f 

50CS V/Voy^. 


Create ControlTemplate Resource 


Name (Key) 


④ EnemyTemplate 


Apply to all 


Define in 

O Application 

® This document 

LayoutAwarePage: pageF v 

O Resource dictionary 

Standard Styles.xaml 


OK 


Cancel 


You C3y\ also use the 

Do 乙 ur»»eirt Outline 

window -fco select 

the gvid i-P i*t gets 
desde^ted- 


❺ 


o 


Your newly created template is currently selected in the IDE. Collapse the Document Outline window so it doesn’t 
overlap the Toolbox. Tour template is still invisible, but you’ll change that in the next step. If you accidentally click out of 
the control template, you can always get back to it by opening the Document Outline, right-clicking on the Content Control, 
and choosing Edit Template—Edit Current 

Make suv-c you do〆 七 c\\ck else m desiy>ev urrtil 

Edit the enemy template, you see ellipse. Tl^ai Will keep *tKc sclcd-tcd- 

Add a red circle to the template: 


Double-click on 


Ellipse 



in the toolbox to add an ellipse. 


Set the ellipse’s Height and Width properties to 100 , 
which will cause the ellipse to be displayed in the cell. 

Reset the Horizontal Alignment, 

Vertical Alignment, and Margin properties by 
clicking on their squares and choosing Reset. 

Go to the Brush section of the Properties window and click 
on 國 to select a solid-color brush. 

Color your ellipse red by clicking in the color bar and 
dragging to the top, then clicking in the color sector and 
dragging to the upper-right corner. 


Stroke 

m 

Editor 


m 


Clidk *m "this Co\oy 
sclcd-fcov- drag 
"to the 
^ov^cv-. 


Mo brush 

[3 □ 

Collor resources 

R 255 


□ 


O 


GO 


BO 


A 100% 


^ % #FFFF0000 


The XAML for your ContentControl now looks like this: 

(ContentControl Content="Content Control" HorizontalAlignment= 11 Center" 

Vertica 1Aiignment = rr Cente r M T emplate= rB {StaticResoyrce EnemyTemplate} "/ > 

Scroll around youv wmdow sec i-f you c^y\ -fmd whcv-c 

EnemyTemplate is dc-fmcd- |*t should be below the v-csou\r^c. 

Use the Document Outline to modify the StackPanel and TextBlock controls. 

Go back to the Document Outline (if you see — EnemyTemplate (ContentContno! Template) the top of the Document 


Outline window, just click liJ to get back to the Page outline). Select the StackPanel control, make sure its 
vertical and horizontal alignments are set to center, and clear the margins. Then do the same for the TextBlock. 


you are here ► 

You re almost done laying put the form! Flip lie page for tlie last steps... 
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check out the page you built 


❺ Add the human to the Canvas. 

Tou’ve got two options for adding the human. The first option is to follow the next three paragraphs. The second, quicker 
option is to just type the four lines of XAML into the IDE. It’s your choice! 

Select the Canvas control, then open the All XAML Controls section of the toolbox and double-click 
on Ellipse to add an Ellipse control to the Canvas. Select the Canvas control again and double-click on 
Rectangle. The Rectangle will be added right on top of the Ellipse, so drag the Rectangle below it. 


Hold down the Shift key and click on the Ellipse so both controls are selected. Right-click on the Ellipse, 
choose Group Into, and then StackPanel. Select the Ellipse, use the solid brush property to change its 
color to white, and set its Width and Height properties to 10. Then select the Rectangle, make it white as 
well, and change its Width to 10 and its Height to 25. 


Use the Document Outline window to select the Stack Panel (make sure you see T VP e StackPanel at top of 
the Properties window). Click both 1151 buttons to set the Width and Height to Auto. Then use the Name 


box at the top of the window to set its name to human. Here’s the XAML you generated: 
<5tackPaneI x:Waine= 1 'huiman M， Orientation= 1 VerticaI 1,， > 


〈Ellipse Fill= 1, White 1f Height= 1, l@ 1F Width= 1, l@ 1 7> 

< Rectangle FiII= 1, White 1F Height^as 11 Width = 1, 1@ 1 7> 
< /StackPanel) 


|-f you cMoost *to type *tK*is m*to )<AM^ 

Vmdov/ o-f ID 么 make su\rc you do \i 

above i\\t </Cay>vas> TKa*t s Kov/ you 
Kumdr\ is doy\*ta*mcd m Canvas. 


Go back to the Document Outline window to see how your new controls appear: 


j H playArea 


<2> o 


i 具 human 


O o 


o [Ellipse] 

口 [Rectangle] 


<2> o 
o 


o 


Wken you drag 
a control around 


❼ 


Add the Game Over text. 

When your player’s game is over, the game will need to display a Game 
Over message. You’ll do it by adding a TextBlock, setting its font, and 
giving it a name: 

* Select the Canvas, then drag a TextBlock out of the toolbox and 
onto it. 

* Use the Name box in the Properties window to change the 
TextBlock’s name to gameOverText. 

* Use the Text section of the Properties window to change the font to 
Arial Black, change the size to 100 px, and make it Bold and Italic. 

* Click on the TextBlock and drag it to the middle of the Canvas. 

* Edit the text so it says Game Over. 


a Canvas, its 
Leit and Top 
properties are 
ckangfect to set 
its position. II 
you ckangfe tke 

Leit and Top 

properties, you 
move tke control. 
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start building with c# 


o Add the target portal that the player will drag the human onto. 

There’s one last control to add to the Canvas: the target portal that your player will drag the human 
into. (It doesn’t matter where in the Canvas you drag it.) 

Select the Canvas control, then drag a Rectangle control onto it. Use the 13 button in the Brushes 
section of the Properties window to give it a gradient. Set its Height and Width properties to 50. 

Turn your rectangle into a diamond by rotating it 45 degrees. Open the Transform section of the 
Properties window to rotate the Rectangle 45 degrees by clicking on ^ and setting the angle to 45. 

z 鹵 / ® ㈥ 

Angle 45 ■ 

Finally, use the Name box in the Properties window to give it the name target. 

Congratulations — you’ve finished building the main page for your app! 



you are here ► 


27 


















you took control 










Now that you’ve built a user interface, you should have a sense of what some of the controls do, and you’ve used 
a lot of different properties to customize them. See if you can work out which property does what, and where in 
the Properties window in the IDE you find it. 


XAML property 


Content 


Height 


Rotation 


Fill 


x : Name 


Where to find it 
in the Properties 
window in the IDE 

At tke top 


D Brush 


> Ap pea ranee 



Layout 



What it does 

Determines how tall the 
control should be 


Sets the angle that the 
control is turned 


You use this in your C# 
code to manipulate a 
specific control 


The color of the control 


Use this when you want 
to change text displayed 
inside your control 


Solution on page 37, 


★ 


Here’s a hint: you can use the Search box in the 
Properties window to find properties — but some of 
these properties aren’t on every type of control. 
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start building with c# 


Yo uVg set the stage for the game 

Your page is now all set for coding. You set up the grid that will 
serve as the basis of your page, and you added controls that will 
make up the elements of the game. 


Yon are Jiere! 



sci up the 9 hd. J 


"Thch you added 
^ohtirols -to youv- 
丁 he hex-t step is -to 

_itc Codt that uses 

"thcru. 


XAML Mam Page 
and Containers 


Windows UI 
Controls 


C # Code 


methods^ 

StartGame() 

AddEnemy() 

AnimateEnemy() 

EndTheGame() 



Visual Studio gave you useful tools ior laying 
out your page ，hut all it really diet was kelp you 
create XAML cocte. YouVe tke one in ckarge! 


you are here ► 
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keep your stub for re-entry 


What you'll do next 


Now comes the fun part: adding the code that makes your game 
work. You’ll do it in three stages: first you’ll animate your enemies, 
then you’ll let your player interact with the game, and finally 
you’ll add polish to make the game look better. 


First youll animate tke enemies... 



The -pivst -thmj you'll do 
is add dodc that 

Uuscs Cherries -fco shoot 
out ^CY'oss the play 
cvciry you 

^lidk "the butfcoh. 


A lot of programmers build their code in small 
increments, making sure one piece works before 
moving on to the next one. That’s how you’ll build 
the rest of this program. You’ll start by creating 
a method called AddEnemy () that adds an 
animated enemy to the Canvas control. First 
you’ll hook it up to the Start button so you can fill 
your page up with bouncing enemies. That will lay 
the groundwork to build out the rest of the game. 


To make jamc 

y/ov-k, youll r\ecd 七 he 
pv-oyess bav- *to 
dov/r\, "the *to 

move, d 灼 d the 

*to "the 

Cr\Cn\y jc*ts him o\r 
time Vu^s ou*t. 


### 



ou’ll adxt tke rfamepla 




You used a -template 
*to make comics 
look like \rcd divides. 
Nov/ you’ll update 
*tcmpla*tc *to make 
look like evil 
alien heads. 


•••and iinally ， you’ll 
make it look good. 
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start building with c# 


Add a method that does something 

It’s time to start writing some C# code, and the first thing you’ll do is 
add a method —— and the IDE can give you a great starting point by 
generating code. 

When you’re editing a page in the IDE, double-clicking on any of the 
controls on the page causes the IDE to automatically add code to your 
project. Make sure you’ve got the page designer showing in the IDE, 
and then double-click on the Start button. The IDE will add code to 
your project that gets run any time a user clicks on the button. You 

should see some code pop up that looks like thk_ ^ ^ dou bl 卜 dl. • 如 d ^ 如 Bu 七 U do 士 oUhe 

IDE dveated -this me 七 hod . I 七 will a usev 

dlidks w S*tav •七广 bu*t*tor> *m 

private void start0utton_Click(ob j ect senderj RoutedEventArgs e) 




€lick= M startButton Click" 


Use the IPE to create your own method 

Click between the { } brackets and type this, including the parentheses and semicolon: 

^ private void startButton_Click( object sender^ Routed Eve ntAr g s e ) 

TKc \rcd s^u^^ly Imc is IPS you 
七 hcve’s a pv*oblcw»i d^d blue bo 乂 is *tKc 

IPS you *tKa*t i*t 你 1 #七 i^av/e a solution. 





The IDE also added 
this h> the )<AML. See 

i-f you -fmd it You’ll 

lca\nr» r»\o\rc dbou*t v/ha 七 


•this is *m Chaftev- Z. 


Notice the red squiggly line underneath the text you just typed? That’s the IDE telling you that something’s 
wrong. If you click on the squiggly line, a blue box appears, which is the IDE’s way of telling you that it 
might be able to help you fix the error. 


Hover over the blue box and click the ^ T icon that pops up. You’ll see a box asking you to generate a 
method stub. What do you think will happen if you click it? Go ahead and click it to find out! 

Si ， 

’」© Generate rnethod stub for 'AddEnemy 1 in 'Save_the_Humans.MainPage 1 



Dumb Questions 


What’s a method? 


A method is just a named block of code. 
We’ll talk a lot more about methods in Chapter 2. 


And the IDE generated it for me? 

Yes...for now. A method is one of the basic 
building blocks of programs—you'll write a lot of 
them, and you'll get used to writing them by hand 


you are here ► 
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intelligent and sensible 


Fill m the code for your method 

It’s time to make your program do something, and 
you’ve got a good starting point. The IDE generated a 
method stub for you: the starting point for a method that 
you can fill in with code. 


① 


Delete the contents of the method stub that the IDE 
generated for you. 

private void AddEnemy () 


row new Not limp I eme nt e d E kc e pt ion 


} 



Watch it! 


C# code must be 
added exactly as 
you see it here. 


It’s really easy to throw 
off your code. When 
you're adding C# code to your 
program, the capitalization has to 
be exactly right, and make sure you 
get all of the parentheses, commas, 
and semicolons. If you miss one, 
your program won J t work! 


J 


Sclcdt *tW»s a^d delete V^ 11 
about c%^cp*t'»or\s m li. 


® 


Start adding code. Type the word Content into the method body. The IDE will pop up a window 
called an IntelliSense Window with suggestions. Choose ContentControl from the list. 

private void AddEn-emy() 


Content 


0 _ 


a 




_contentL.o-aded 

Content 


ContentControl 


▲ 


ContentPresenter 
ContentProperty 
Co ntentTh emeT ra nsition 
H orizontalC ontentAI ignm ent: 

H orizontal ContentAI ignm entProp erty 
ScrollContentPre^enter 


T 


® 


Finish adding the first line of code. You’ll get another IntelliSense window after you type new. 


private void AddEnemy() 

{ 

ContentControl eneiry = new ContentControl (_); 

} \ 

This Ime traits a ^ Cohlc^Cohlv-ol object /oull 
le 沘 h abou-t obje^-ts av\d -the keywov-d ih Chapter l, 

Ad variables like ey^y m Chaptev 午 . 
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start building with c# 




Before you fill in the AddEnemy () method, you’ll need to add a line of code near the top of the file. 
Find the line that starts with public sealed partial class MainPage and add this line 
after the bracket ({): 


III <summary> 

III A basic page that provides characteristics common to most applications. 

Ill </summary> 

public sealed partial class MainPage : Save_the_Humans.Common. LayoutAwarePage 

This is U\tA a field. Youll 
lc 扣 h moire dboutTow it 
woirks ih 饮午 . 



Finish adding the method. You’ll see some squiggly red underlines. The ones 
under AnimateEnemy () will go away when you generate its method stub. 


private void AddEnemy() 


TV^is l*mc adds you\r 
C.or\*tv"ol 

-to a tollctt»oir\ called 
CWildv-cn. Yo u ^ 

about dollc^t»o\r\S *m 

9 . ^ 

} 



Vo you sec 3 st \ u, 9jly 

u^dev- play/Wca? 爸。 ba^k h> the 

)<AML cdi*bo\r av\d su\rc you se 七 
■the o( -the Cdl^vas doir^brol 
■to playAv-ca. 




ContentControl enemy = new ContentControl (); 

enemy.Template = Resources[ "EnemyTemplate" ] as ControlTemplate; 

0) playArea.ActualWidth - 100, "(Canvas. Left)"); 
enemy, random. Next ( (int) playArea .ActualHeight - 100), 
random.Next( (int) playArea.ActualHeight - 100), "(Canvas.Top)"); 
playArea.Children.Add(enemy); 


1-(* you Y\ttd *to swi*tdh between C 非 

Code, use -the -tabs a*t *thc *tof of ihe window. ^ 


MainPage.xaml 


MainPage.xaml.es 



( 6 ) Use the blue box and the ^ T button to generate a method stub for AnimateEnemy (), just like you 


did for AddEnemy () . This time it added four parameters called enemy, pi, p2, and p3. Edit the 
top line of the method to change the last three parameters. Change the parameter pi to from, the 
parameter p2 to to, and the parameter p3 to propertyToAnimate. Then change any int types to 

double. 


private void AnimateEnemy ( ContentControl -enemy^ ^nt ^plj double p 2 ^ string p 3 ) 


lcav-h 

about methods } 
pamarhetev-s 
ih Chap-tcir Z. 


throw new NotlrrplefrentedException () 


private void AnimateEnemy (ContentControl enemy 


The IPE may -the method siub 

w'rth -types. D>a 哼 -them *to w doublc W . 
Youll leav-^ about types m Chaftev 午 . 




fronij ^ouble^to, string propertyToAnimate) 


Flip tfce paigetP see yout program tun! 




you are here 





















ok, that’s pretty cool 


Finish the method and ruw your program 

Your program is almost ready to run! All you need to do is finish your 
AnimateEnemy () method. Don’t panic if things don’t quite work 
yet. You may have missed a comma or some parentheses —— when you’re 
programming, you need to be really careful about those things! 



❶ 


you 

Wo 


like these let 
use todt 
m .NET 
libv-av-ics 
tofrst V/i*th 

c 养 . youii 

\cByY\ more 
abou 七 them \ y \ 
Chapter Z. 


Add a using statement to the top of the file. 

Scroll all the way to the top of the file. The IDE generated several 
lines that start with using. Add one more to the bottom of the list: 

Busing System^ 

using System,Co lie ctions.Generic^ 
using System.10^ 
using System.Linq^ 
using Windows.Foundations 
using Windows.Foundation.Collections^ 
using Windows.UI.Xanl^ 
using Windows. UI.Xaiml . Cont ro 1 sj 
using Windows.UI.Xaml ■ Controls . Primitives 
using Windows.UI.Xaml.Data^ 
using Windows.Ul.Xaml.Inputi 
using Windows.UI.Xaml . Media^ 
using Windows.UI.Xaml . Navigation^ 


Still seeing red? 
^ 1 The IDE helps 

fvi^JCiA you track down 

problems. 

If you still have some of those red 
squiggly lines, don’t worry! You 
probably just need to track down 
a typo or two. If you’re still seeing 
squiggly red underlines, it just means 
you didn’t type in some of the code 
correctly. We’ve tested this chapter 
with a lot of different people, and we 
didn’t leave anything out. All of the 
code you need to get your program 
working is in these pages. 


Vo^ II h«d this li hC io make ihe bit 

„ 卜 wthe UelliScst 


llltlbi J.UI I J 


This 


❹ 


using Windows.UI.Xaml.Media.Animation 

-to move ihe e^ ics Gh yo[A ； 

Add code that creates an enemy bouncing animation. 

You generated the method stub for the AnimateEnemy () method on the 
previous page. Now you’ll add its code. It makes an enemy start bouncing across 
the screen. 


\rs 


^/ou II Icav-^ about 
objedt 'm'rtializjC 
like this'm 
Chapter 午 . 


private void AnimateEnemy (ContentControl enemy^ double from, double to, string pnopertyToAnimate) 


And you’ll 
abou 士 七 ioh 

… Chaptev* / 厶 . 


Storyboard storyboard = new Storyboard () { AutoReverse 

DoubleAnimation animation = new DoubleAnimation () 


From = from. 

To = to. 

Duration = new Duration(TimeSpan .FromSeconds(random.Next(4, 6))) 


}; 

Storyboard .SetTarget(animation, enemy ); 

Storyboard . SetTa r get Property (animat ion propertyToAnimate) 
storyboard.Children.Add(animation); 
storyboard.Begin()j 


true. RepeatBehavior = RepeatBehavior. Forever }; 

This todt makes the 
Cherry you 

move 

此⑽ playA^ca. ^ you 
乙 hahge 午 ahd 久 you M 


you 匕如 
… ake the ehemies move 
slower ov- -Pas-tcv-. 


❺ 


Look over your code. 

You shouldn’t see any errors, and your Error List window should be 
empty. If not, double-click on the error in the Error List. The IDE will 
jump your cursor to the right place to help you track down the problem. 


^ y ou see the 

L |S 七 choose Ev-vo^* 

the \/icw mehu 
show it. Youll leav-h 
about usihg ihc t^o\r 


wmdow dhd deb 


^odc ih Chdp-tcv* Z. 


“ 33 ih 3 youv 
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start building with c# 


Here’s a hint: if you move too many windows 
around your IDE, you can always reset by choosing 
Reset Window Layout from the Window menu. 

Q Start your program. 

Find the ► button at the top of the IDE. This starts your program running. 


App4 - Microsoft Visual Studio Express 2012 for Windows S 
FILE EDIT VIEW PROJECT 旦 UILD DEBUG TEAM IDOLS STORE TEST WINDOW HELP 



This button starts your program. 


❺ Now your program is running! 

First, a big X will be displayed for a few seconds, and then your main page will be displayed. Click 
the “Start!” button a few times. Each time you click it, a circle is launched across your canvas. 



This big )( is the splash 
styttY\- Youll make youv 
ovm splash at the 
<A the dhaptev-. 



I-P "the enemies aireir / 七 bouhdmg, 

oy i*f they leave the play area, 
double - dhedk -the Code- V^u may 
be rwiss'mj pavc^-thcscs o\r keyy/ov-ds. 




lo^, \^i l«kc y/c 
•to do bo y t v 吵七 . 



❺ Stop your program. 

Press Alt-Tab to switch back to the IDE. The ^ button in the toolbar has been replaced with " B 。 to 
break, stop, and restart your program. Click the square to stop the program running. 


you are here ► 
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what youVe done, where you 1 re going 


Here's what youVe done so far 

Congratulations! YouVe built a program that actually does 
something. It’s not quite a playable game, but it’s definitely a start. 
Let’s look back and see what you built. 


Yon are Jiere! 


XAML Main Page 
and Containers 


Windows UI 
Controls 


C # Code 


deployment 

Package 




Tar# 

(Tick event handle^ 



fTick event handled 


f VC ± ^ ^ good 
也 K by buildihg 

useir 此 irfad. 




App 

manifest 




This step is whcv-c wc 

wite C# Code that 
•^akes -the gameplay 


\ruh. 




...wt ^ ^ f 

vest ^ 

M 


Visual Stuctio can generate code lor you，tut you 

need to know wkat you want to kuilct BEFORE 

you start tuilcting itt It won’t cto tkat lor you! 
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start building with c# 


Here’s the solution for the “Who Does What” exercise on page 28. 
We’ll give you the anwers to the pencil-and-paper puzzles and 
exercises, but they won’t always be on the next page. 










solu 七 


lOh 


Now that you’ve built a user interface, you should have a sense of what some of the controls do, and you’ve used 
a lot of different properties to customize them. See if you can work out which property does what, and where in 
the Properties window in the IDE you find it. 


XAML property 


Where to find it 
in the Properties 
window in the IDE 


Content 



At tke top 


^ Brush 


> Appearance 


t> Common 


L^youi 


> Transform 



What it does 

Determines how tall the 
control should be 


Sets the angle that the 
control is turned 


You use this in your C# 
code to manipulate a 
specific control 


he color of the control 


Use this when you want 
text or graphics in your 
control 


Koy/ you set ^ ^ . 

Ca^as ,o^ol 义二七々 

m KandY m a 70U y/ntc 

todc *to v/ov-k i\\t Canvas. 


you are here ► 
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tick tick tick 


Add timers to manage the gameplay 


Let’s build on that great start by adding working gameplay elements. This game adds 
more and more enemies, and the progress bar slowly fills up while the player drags the 

human to the target. You’ll use timers to manage both of those things. you vc 

' doy>*tams dodc (or a dlass tailed MamPa^c- 


o 


o 


ADD UINBS TO THE TOP O? Y^UE 6# lea^ about classes m 

Go up to the top of the file where you added that Random line. Add three more lines: 

III <summary> 

III A basic page that provides characteristics common to most applications. 

Ill </ summany> 

public sealed partial class MainPage : Save_the_Humans.Common. LayoutAwarePage 



Add these *tWcc Imcs 
below the you sddtA 
bc-forc- These av-c -fields, 
av\A you II \tarv\ about 
•them m 午 . 


Random random = new Random ( ); 

DispatcherTimer enemyTimen = new DispatchenTimer( ); 
DispatcherTimer targetTimer = new DispatcherTimen( ) 

bool humanCaptuned = false; 

ADD A METHOD OhiB O? Y^UE TIMBES- 

Find this code that the IDE generated: 

public MainPage() 

{ 

this .Initial!zedompo ne nt(); 


Put your cursor right after the semicolon, hit Enter two times, and type 
enemyTimer . (including the period). As soon as you type the dot, an IntelliSense 
window will pop up. Choose Tick from the IntelliSense window and type the 
following text. As soon as you enter += the IDE pops up a box: 

enemyTimer.Tick += 

ememyTime^TEck.; [Press TAB to ins.ert) 


Tick 



Timers ” tick” 


Press the Tab key. The IDE will pop up another box: 

e n emvTime r .Tic k +=enemYTiiner Tick; 

Press TAB to generate handler 'enemyTime^Tick 1 in this class 

Press Tab one more time. Here’s the code the IDE generated for you: 
public MainPage ( ) 

{ The IPS ^c^cvaicd 

this.InitializeComponentOi a U you 

enemyTimer.Tick += enemyTimer_Ticki ^llcd 3^ cvctfil 

} j/ haiadlcv-. You II lcavv> 

^ about cvcn*t i^a^dlcv-s 

void enemyTiniier 一 Tick (object sender^ object e) •… |*$ 

throw new NotlmplerentedException ( )^ 
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every time 
interval ty 
calling metkocts 
over ami over 
again. You’ll use 
one timer to add 
enemies every 
lew seconds, anct 
tke otker to enct 
tke game wken 
time expires. 




❺ 


o 


/ - \{!s normal add ^rtv\i\\tsts 0 

^i\\ty\ v/v.i 七 .nr^ 3bou*t 3 method- 
FINISH THE MainPa 公 eO METHOD- D 

You’ll add another Tick event handler for the other timer, and you’ll add 
two more lines of code. Here’s what your finished MainPage () method 
and the two methods the IDE generated for you should look like: 

public MlainPage() 

{ 

this. InitializeComponent () ^ 


enemy.Tinter .Tick += enemyTimer_Tic 
enemyTimer ■ Interval = T i n - e S p a n . F romS e co nd s ( 2 ) 


t a r getT ime r . Ti c k += t a r getTirie r_T i c 
targ-etTimer. Interval = TiEi eSpan. FrontSeconds ( „ 1 )\ 


} 




start building with c# 

Right now your Start button 
adds bouncing enemies to the 
play area. What do you think 
you’ll need to do to make it 
start the game instead? 




void targetTimer_Tic k ( object senderj object e) 
throw new Not Imp I erne nt e d E kc e p t i o n ( ) ^ 

} 

void e nemyT imer_Tic k (o bject sender) object e) 


} 


throw new NotImplement.edException(); 


Tv-y 心十 3 

r\uw>bcv-s ov\Ct your 

is Hoy/ 

does that 

jamcflay? 


2 S 3 ⑽ ated these I 一 as 
L add y ° U ? ^ sscd Tab 

to add ih c Ti^k cvc „i 

/ou II ,e P la,e ^ ^ ^ 

妙心⑽ y t Ws 悅 k. 


ADD THE BNt>T^me() METHOD. 

Go to the new targetTimer_Tick () method, delete the line that the IDE generated, and add 
the following code. The IntelliSense window might not seem quite right: 

void ta r getTimer_Ti c k ( ob j e ct sender^ object e) 


Pid |PE ■ 

keef -tv-y'mj 
■to ^afitaliz^ 

•the P m 

fv-oycssBav? 
ThaVs because 

thcv-c v/3s Y\0 

lowcv-dasc-P 

pv-oycssBav-, 

BY\d the 

dloscst 
it 6ould 
-f md was *thc 
•type o-f -the 


proeressBar.Value += 1; 

if ( proeressBar.Value >= proeressBa r . Maximum) 

' IvW%A>WH/WW ^wWuWVWW * 

EndTheGamef ) ; 

»WWWWVW 、 , 



(-P you closed the Dcsi^hcv tab 
that had the XA/WL code, 
doublc-dlidk oh /Wa'mPagc. 

ih the Solutioh Explov-cv- 
v/ihdow -fco b\rihg it up. 


Notice how progressBar has an error? That’s OK. We did this on purpose (and we’re not even 
sorry about it!) to show you what it looks like when you try to use a control that doesn’t have a 
name, or has a typo in the name. Go back to the XAML code (it’s in the other tab in the IDE), find 
the ProgressBar control that you added to the bottom row, and change its name to progressBar. 

Next, go back to the code window and generate a method stub for EndTheGame (), just like you 
did a few pages ago for AddEnemy () . Here’s the code for the new method: 

private void EndTheGame() 


^ 5^0vc^i up 

if (IplayArea.Children.Contains(g^g^J^J)) as ^ tYYoY, i-f ： ry»cahS Vou 

〆 sci ihc 

七 he 

0 v C / J TcxtBlo^k. 6 ^o 


enemyTimer.Stop(); 
targetTimer.Stop(); 
humanCaptured = false; 

startButton.Visibility = Visibility .Visible 
playArea.Children.Add(gameOverText): 


ahd do \i h 0 w. 


This method ends the 
game by stopping the 
timers, making the 
Start button visible 
again, and adding 
the GAME OVER text 
to the play area. 


you are here ► 
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so close i can taste it 


Make the Start button work 

Remember how you made the Start button fire circles into the Canvas? Now 
you’ll fix it so it actually starts the game. 


❶ 


❻ 


Make the Start button start the game. 

Find the code you added earlier to make the Start button add an 
enemy. Change it so it looks like this: 

private void sta rt Button_C lick ( obj ect senderj RoutedEventArgs e) 


StartGamef ) 



l/Vkh you iW\s lihc, you 

the bu*ttoh 

ik game ihs-tcad o-P just add— 

ah ChCrw y "to the playAvca Canvas. 


Add the StartGame() method. 

Generate a method stub for the StartGame () method. Here’s the 
code to fill into the stub method that the IDE added: 


private void StartGame () 

{ 

human .IsHitTestVisible = true^ 
humanCaptured = falser 
progressBar.Value = 
startButtcm ■Visibility = Visibilit; 
playArea.Children.'Clear( 
playArea.Children. Add (target ) i 
playArea.Children .Add(human ) j 
e nenryTimer. 5tart () j 
ta rgetT inner. Start 


V^“’ll dbou 七 

|sfii-t7cs-t\/isiblc \y\ 
Chap 七饮 I 弓 . 


Collapsed. 


Cm 

We’re giving you a lot of code to 
type in. 

By the end of the book, you'll know 
what all of this code does—in fact, 
you’ll be able to write code just like it 
on your own. 

For now, your job is to make sure 
you enter each line accurately, and 
to follow the instructions exactly. This 
will get you used to entering code, 
and will help give you a feel for the 
ins and outs of the IDE. 

If you get stuck, you can download 
working versions of MainPage.xaml 
and MainPage.Xaml.es or copy and 
paste XAML or C# code for each 
individual method: 

http://www. headfirstlabs. com/hfcsharp. 


Did you *to sc*t *tv>c v>amcs o( 

'-the ov 七 he Wma 的 

V^ u ^ 1 °°^ a P a 5 cs 

badk bo make suve you se 七 
y>ames -fov all o( 七 i 化 dov>*tvols. 


❺ Make the enemy timer add the enemies. 

Find the enemyTimer_Tick () method that the IDE added for 

you and replace its contents with this: 

void enemyTimer 一 Tick (object sender ： object e) 

{ 一 
AddEnemyOi 

} Are you seeing errors in the Error List window that don’t make 

sense? One misplaced comma or semicolon can cause two, 
three, four，or more errors to show up. Don’t waste your time 
trying to track down every typo! Just go to the Head First Labs 
web page — we made it really easy for you to copy and paste all 
of the code in this program. 




Or\tt you \rc used "to y/o\rkmg with 
toA ^ yodi be good ai spoUmg those 

你 issihg pa\rchthcscs ; scmidolohS, tit. 
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► http://www.headfirstlabs.com/hfcsharp/ 















start building with c# 


Ruw the program to see your progress 


Your game is coming along. Run it again to see how it’s shaping up. 




W\\tY\ you press -the w S*ta\rt"’ button ， 
i*t disaf>^ears, dlcav-s the enemies, a^d 
stav-b the pv-oyess bav -fillip uf. 


Save the Humans 



o 

0 , Akit! Our spies 

JiaVe reported tJiQt th 
Jiumans £ire kullcllng up 
tfce!r detenses! 


e 


The play av-ca slowly s-tav-b -to -Pill up 
v/ith boWmg enemies. \ 









W\)cy\ the fvoyess bav- ai the 
b<rttor^ fills up, tk Cv\ds 

the O^tY text is 

displayed. 

f 

The target timev- should •Pill uf 
slowly, ahd the Chevies should appeav* 
cvcjry two sedohds. I-P the iirhih0 is 
^akc su\rc you added all the 
I'n^cs -to the /WaihRageO method. 





What do you think you’ll need to do to get the rest 
of your game working? 


Flip tfce p£lge t 9 find out! 


you are here 
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in any event... 


Add code to make your controls 
interact with the player 

You’ve got a human that the player needs to drag to the target, and a 
target that has to sense when the human’s been dragged to it. It’s time 
to add code to make those things work. 


Make sure you switch back 
to the IDE and stop the 
app before you make more 
changes to the code. 

Youll mov-c 
ha 於 dlers ’m 七 he 


① Go to the XAML designer and use the Document Outline window to select human Properties y/'mdow 
(remember, it’s the StackPanel that contains a Circle and a Rectangle). Then go to the •m 午 . 

Properties window and press the ^ button to switch it to show event handlers. Find 
the PointerPressed row and double-click in the empty box. 


具 


roperties 


Name human 
Type StackPanel 
Pointe「Exited 
Pointe「Moved 
PointerPressed 
Pointe「Released 


f 


▲ 


Double—^li^k ih this box. 




丁 he DodurwCh-t Outline 
wy have Collapsed C^\d 3 , 
playAv-ca, othev- I'mes. 

W it did, just expand 
"to Tihd "the liumdh dohtirol. 


Now go back and check out what the IDE added to your XAML for the StackPanel: 
<StackPanel x:Name: ’’human 111 0^ientation= l, Ve^tical ,, Point erPressed= IF human PointerPressed 111 〉 

It also generated a method stub for you. Right-click on human_PointerPressed in 
the XAML and choose “Navigate to Event Handler” to jump straight to the C# code: 

private void hjman_Point0rPres5edl( object sender^ PointerRoutedEveritAngs e) 


0 
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} 

Fill in the C# code: 

private void hunan 一 PointerPressed (object sender 】 PointerRoutedEventArgs e) 

{ 一 

if (enemy Timer.IsEnabled) 


humanCaptured = truej 
human ■■ I sH it Test Visible 


false: 


If you go back to the designer and 
click on the StackPanel again, you’ll 
see that the IDE filled in the name 
of the new event handler method. ■ 
You’ll be adding more event handler 
methods the same way. 

Chapter 1 


Properties 


貝 


Name hyiman 


You can use these 
buttons to switch 
between showing 
properties and 
event handlers 
in the Properites 
window. 


Type StackPanel 
Pointe「Exited 
PointerMoved 

PointerPressed huiman_PomterPre：ssed 

Pointe「Released 



▲ 


▼ 


















Make su\rc you add 七 he v-ijh-t cvc^i handler/ V^>u added a start building with c# 

Poi^*^cv"P\rgsseci cvc^*t i">3^cilcv* "to "the humol^ bu't y \ o^i youVc 

^ addmg a Pomtc^r&vtcvrd ^tv\i ha^dlcv -fco -the target 

Use the Document Outline window to select the Rectangle named target, 
then use the event handlers view of the Properties window to add a 
PointerEntered event handler. Here’s the code for the method: 

private void tar,get 一 PointerEntered (object sender^ PointerRautedEventArgs e) 

{ 一 

if (targetTimer.IsEnabled ElSl humanCaptured) 


When the Properties 
window is in the mode 
where it displays event 
handlers, double¬ 
clicking on an empty 
event handler box 
causes the IDE to add 
a method stub for it. 


progressBar.Value = 

Canvas. SetLeft(target^ r a ndomi 」 Next ( (int)p layArea.Act u alWidth 
Canvas .SetTop (targetj random, Next (( in_t) playArea ■ ActualHeight 
C a nvas. Set Lef t (h uma n j r a ndomi - W ext ( lS^j. (int)pl ayArea. Act u a lWidth 
Canvas ■.Set Top (human j random .Next (1 桃】 (int)playArea. ActualHeight 
humanCaptured = falser 
human . IsHitTestVisible = true; 


1 叫 ) 
1 叫 ) 
1 ㈣ )）； 
1 ⑽) U 


Properties ，，二 


3 X 

Name target 


f 


Type Rectangle 
PointerCanceled 
Po inte rCapture Lost 
Pointe「Entered 
Po inte「Exited 


▲ 


ta rg ： et_PointerE nte red 


You II Y\ttd *to swrtdh youv Pv-opcv-tics window ba^k 
•to show pv-opc\rtics ms*tcad o( ha^dlcv-s. ^^ 

® Now you’ll add two more event handlers, this time to the pi ayArea Canvas control. You’ll need to find the 
right [Grid] in the Document Outline (there are two of them —— use the child grid that’s indented under 
the main grid for the page) and set its name to grid. Then you can add these event handlers to play Area: 

private void p 1 ayAre a_Po inte rMo ved ( o b j e c t sender: Pointer Rout e d Eve nt Ar gs e ) ThaVs 3 1 。七 

if (huimanCaptured) V"C3lly 3ir\cl yt 

f 七 he 晰 v ■ 吵七 . 

Point pointe「Position = e. G etc u r re nt Point( n u1 1) . Po s it ion ^ \k 

These -two vc\rtidal 
bav-s a\rc a lo ㈣ I - 
opcv*a-fco\r. YoJW 
lcav->r> about "them 
•m Chapicv- Z. 


Point pointerposition = e.G etC u rre nt Point( n u II) .Position ^ \k 

Point relativePosition = grid.TransforinToVisual(playArea). TransformPoint (pointerPosition) 
if (( 'ath B Abs(relativePosition.X - Canvas.GetLeft(human)) > human. Act u alWidt h * 3) 

( .ath . Abs (relative Posit ion. Y - Canvas J GetTop(huiman)) > human. Act u a lHe ight * 3)) 


humanCaptured = falser 
human.IsHitTestVisible 


true: 


else 


C a n v a s .Set Left (h um a n ^ re 1ati ve Po sitio n .X - human. Act u alWidt h / 2)^ 
Canvas .SetTop (humanj relativePosition- Y - human. Act u alHeight / 2)^ 


You can make the 
game more or 
less sensitive by 
changing these 
3s to a lower or 
higher number. 


private void playArea_PointerExited (object sender 】 PcinterRoutedEventArgs e) 


if (humanCaptured) 
EndTheGarie( 


roperties 


HI 


Make suve you put the vijh-t todc 
•m -the Correct, hahdlcv/ 

IW 七 Widwtally swap them. 


Name playArea 
Type Canvas 
Po inte「Exited 
Points rMoved 
PointerPressed 


f 


playArea_Poi nter Exited 
pl-ayArea_Poi nterMoved 


▲ 


▼ 


PointerReleased 


you are here ► 
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you can't save them all 


Pragging humans onto enemies ends the game 


When the player drags the human into an enemy, the game should end. Let’s add the code to do that. 
Go to your AddEnemy () method and add one more line of code to the end. Use the IntelliSense 
window to fill in enemyPointer . PointerEntered from the list: 


private void AddEnemy() 

{ 

Con-tenitControl •enemy _= new ContentControl( 

enemy. Template = Resources [ 11 EnenyTem plate"] as Controller platen 
An iim ate E nemy ( e nemy^ pi ayAre a - Act u a lWidt h — 1 ⑽】 "(da nva s. Left ) 11 ) " 3 

AnimateEnemy(enemy^ random.Next ( (int )playArea.ActualHeight - 10^)^ 

r andom, Next (( int ) ( p 1 ayArea, Act u alHeight - 2 "(danvas.Top) 11 ); 


piayArea.Children.Add(enemy ); 
enemv, Point-erl 




Stav-t iypmj -this [\y\c o( 
Codt- As soo 灼 as you 
七 he do{„ ^y\ 1^-tdliSc^sc 
v/’mdow v/ill pop up. 

七 yP m 3 W Po •… -to jump 
dovm 仏七 he c^iv-ics m 
the list tha-t start v/i-th 
W Poi>rtd’’ 


® C a ptu rePointer 
f PointerCanceled 
f P o i nterCa ptu reLost 
M PointerCaptures 


PointerEntered 


f PointerExited 
f PointerMoved 
f PointerPressed 

f PointerRel eased ▼ 


Heve’s lastlme J you\r 

me 七 hod. Put youv 
匕 uvsov a 七 {\\t tr\A c^f 七 he Ime 
ar\d \\\i *to add 

Imc Code- 

PointerEventHandler UIEIement.PointerEntered 

Occurs when a pointer enters the hit test area of this element. 


Choose PointerEntered from the list. (If you choose the wrong one, don’t worry ― just backspace 
over it to delete everything past the dot. Then enter the dot again to bring up the IntelliSense window.) 


Next, add an event handler, just like you did before. Type += and then press Tab: 


enemy.PointerEntered += 



_ 

eneiiny_PointerEntered; (Press TAB to insert) 


V^ull Ica^ all aboui 
how eveivt hdndle\rs like 
■this v/o\rk *m Chap 七 ev I 弓 . 


Then press Tab again to generate the stub for your event handler: 

enemv . PointerEntered += eneimy PoiirterEnteredl; 

Press TAB to generate handler ' enemy_PointerEntered 1 in this class 


Now you can go to the new method that the IDE generated for you and fill in the code: 

void e nemy 一 Pointe「Entered (object senderj PointerRoutedE 1 . sntArgs e ) 


} 


if (h uman-Captured ) 
EndTheGame( ) m 3 
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start building with c# 


Your game is how playable 

Run your game —— it’s almost done! When you click the Start button, your play 
area is cleared of any enemies, and only the human and target remain. You 
have to get the human to the target before the progress bar fills up. Simple at 
first, but it gets harder as the screen fills with dangerous alien enemies! 


Drag tke kuman to safety! 





The aliens ohly sPChd theiv- 
"time -ro\r movih0 

hurrahs, so the ohly 
Chds i-p you 

oh-fco ^y\ ehemy. Ov\C，c you 

"the Kc S 

tcmpo\ra\rily sa-Pc aliens. 


Get kim to tke target teiore time’s u 


Look though -the Code ahd -fihd 
wheire you set tk (sl+itTcsH/isiblc 
pv-opevty oh the I/Wh 

its oy \, the ih-tevdepts the 

Poih-tc\rEh-tc\rcd cveh-t bemuse £ke 

hurrah s £*tadkRahd dohtv-ol is si-fc-tih^ 
bc-tv/cch the Cherry ahd the pomtd 



...tut drag too last, anct youll lose your kuman! 



you are here ► 
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bells whistles aliens 


Make your enemies look like aliens 


Red circles aren’t exactly menacing. Luckily, you used a template. 
All you need to do is update it. 



Go to the Document Outline, right-click on the ContentControl, 
choose Edit Template, and then Edit Current to edit the template. 
You’ll see the template in the XAML window. Edit the XAML code 
for the ellipse to set the width to 75 and the fill to Gray. Then add 
Stroke = 1- Black" to add a black outline, and reset its vertical and 
horizontal alignments. Here’s what it should look like (you can delete 
any additional properties that may have inadvertently been added 
while you worked on it): 



Seeing events 
instead of 
properties? 


You can toggle the 
Properties window 
between displaying properties or 


events for the selected 
control by clicking the 
wrench or lightning bolt icons. 


f 


^Ellipse Fill= ， _Gra y tp H!eight=”100 M Width= M 75" Stroke^ 11 Black n， /> 


o 


Drag another Ellipse control out of the toolbox on top of the existing ellipse. Change its Fill to 
black, set its width to 25, and its height to 35. Set the alignment and margins like this: 


HorizontalAlignm... 

VerticalAlignment 

Margin 



V<>0 ^ ^Iso w cycball w it *tv>c by usm^ 

mouse ov avvoy/ keys *to dva^ 七 he ellipse m*to 

pld 以 . Tiry usm^ Co^Y p3s*tc "to 

dofy ellipse fas*tc ^oi\\cy oy\c oy \ *tof o( \i- 



Use the / button in the Transforms section of the Properties window to add a Skew transform: 

•rj 閩 / 0 肉 

X 10 ■ Y 0 □ 


o Drag one more Ellipse control out of the toolbox on top of the existing ellipse. Change its fill to 
Black, set its width to 25, and set its height to 35. Set the alignment and margins like this: 


HorizontalAlignm... 

1-= 

-1 1=1 

■ 

VerticalAlignment 

同 li 

ii n 

■ 


Margin 

如 70 

♦ 40 


♦ 20 

* 0 

and add 

a skew like this: 



鹵 / ® 


X -10 

園 Y 0 

□ 


■ 


youv enemies 
look a lo 七 move like 

aliens 
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start building with c# 


Add a splash scrccw and a tile 

That big X that appears when you start your program is a splash 
screen. And when you go back to the Windows Start page, there it 
is again in the tile. Let’s change these things. 

Expand the ^ Assets folder in the Solution Explorer window and 


Don’t feel like making your own splash 
screen or logos? You can download ours: 
http://www.headfirstlabs.com/hfcsharp 


Solution Explorer 




lH T 0 ▼ 贫 W 圖身 P 

Search Solution Explorer (Ctrl+:) 

Solution 'Save the Humans' [1 project) 
d [c5] Save the Hu mams 
> S* Properties 
■ References. 

^ 由 Assets 

R1 Logo,png 
SmallLogo.png 


Splash Screen；, png 


StoreLogo,png 

> _ Common 

> App.xaml 

J D MainPage.xaml 

> tl MainPagexaml.es 

Hi^l Package.appxmanifest 

|E3 Save the Hutnans_TemporaryKey■ pfx 


P 



you’ll see four files. Double-click each of them to edit them in Paint. 
Edit SplashScreen.png to create a splash screen that’s displayed when 
the game starts. Logo.png and SmallLogo.png are displayed in the Start 
screen. And when your app is displayed in the search results (or in the 
Windows Store!), it displays StoreLogo. 


I 过 i id 


Clipboard 




SplashScreen - Paint 


Home View 


❼ 


f - ■} 

! ^ / (t> \ 

1 - [P 



Brushes 

Image Tools 



W O □ ▲ P Outline • 

OZiAl\ - 公 FHI， 

oooo ^ 

Shapes 



匾 

Size 

Color 

▼ 

1 


Head First C# 

presents 

SAVE THB 
HUMANS 




tg 620 X 300px 


I Size: 36.2KB 


C T □□□□□□□□□□: 

Colors 

Some editions 

<Jc Visual 

Studio use 

yapiViC 
cd'i*tovs 
ms*tcad o*f 
MS Pamt 

100% © 0 ® 


<ControlTemplate x: Key= ,, EnemyTemplate" TargetType= ,, ContentControl"> 
<Grid> 


〈Ellipse Fill= ,, Gray M Stnoke= ,, Black n Height="100 M Width="75 M /> 

〈Ellipse Fill="Black" Stroke="Black" Height= M 35 M Width= ,, 25 M 

HorizontalAlignment=" Center" VerticalAlignment= "Top" 

Margin="40, 20^70^0" RenderTransformOrigin= ,, 0. 5^0.5"> 

< Ellipse.RenderTransform> 

<CompositeTransform SkewX= ,, 10 ,, /> the updated XA/WL the 

</Ellipse.RenderTransform> 於 w ihai you Seated- 

</Ellipse> 

〈Ellipse Fill="Black” Stroke= ,, Black" Height= M 35 M Width="25" 
HorizontalAlignment= ,, Centen" VerticalAlignment= ,, Top" 

Margin="70 > 20^40^0" RenderTransformOrigin= ,, 0. 5^0.5"> 

< Ellipse.RendenTransform> 

<CompositeTransform SkewX="-10"/> 

</Ellipse.RendenTransform> 


</Ellipse> JUST Om THIN 公 Y^U NBBD TO l>0 

</Grid> 

</ControlTemplate> PUAY y^>ue ^AMBJ 

See i-P you e,av\ jet a^d ihe way A^d Aor\i -fovyt -to s*tcf ba 己 k a 的 d pally 

■the play av-ca, enemies look. appv-ctid'tc v/Ka*t you built 今 ood job. you are here ► 
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your app becomes everyone^ app 

Publish your app 

You should be pretty pleased with your app! Now 
it’s time to deploy it. When you publish your app 
to the Windows Store, you make it available to 
millions of potential users. The IDE can help 
guide you through the steps to publish your app to 
the Windows Store. 

Here’s what it takes to get your app out there: 


Yon are Jiere! 



O Open a Windows Store 
developer account. 


© Choose your app’s name, set an 
age rating, write a description, 
and choose a business model to 
determine if your app is free, 
ad-supported, or has a price. 


© Test your app using the 

Windows App Certification Kit 
to identify and fix any problems. 


© Submit your app to the 
Store! Once it’s accepted, 
millions of people around the 
world can find and download it. 


STORE TEST WINDOW HELP 
Open Developer Account... 
Reserve App Name... 

Acquire Developer License... 

Edit App Manifest 
As&ociate App with theStore... 

Ca pture Sc reensh ots … 

Create App Packages... 

Upload App Packages.. B 


A 

The S-fcovc 你⑽ m 七 1^ IDE has all of 七 he 

"tools you y\tt& publish youir app. 

外 


TV>v-ou^ou*t book y/e’ll show you >whcv-c *to 
move -fvom MSPN) A1*idvoso^*t 

Pcvclofcv Mcivjork. This is a really valuable 
七 ha 七 helps you keep c%pay>d*m5 youv k^oy/lcd^c- 


|h sonr»c editions of \/isual Studio, 七 he 
l/Vi 灼 dov/s S-to\rc options appear 七 he 

Pvojcdi rwcr^u msicad o( ihciv- ov^m 

■top-level S-fcovc menu. 



You can learn more about howto publish apps to the Windows Store here: 
http://msdn.microsoft.com/en-us/library/windows/apps/jj657972.aspx 
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start building with c# 


Use the Remote debugger to sideload your app 

Sometimes you want to run your app on a remote machine without publishing it to the 
Windows Store. When you install your app on a machine without going through the 
Windows Store it’s called sideloading, and one of the easiest ways to do it is to install 

the Visual Studio Remote Debugger on another computer. 


Here’s how to get your app loaded using the Remote Debugger: 
* Make sure the remote machine is running Windows 8. 


time this is bcihg v/v-i-fc-tch, you’ll 
Tiols l/isual Studio 
Update 1 ,^ but you may -f md 
-Putuirc updates. 


★ Go to the Microsoft Download Center {http://wwmmicrosoft.com/en-hk/download/default.aspxyon the 
remote machine and search for “Remote Tools for Visual Studio 2012.” 

★ Download the installer for your machine’s architecture (x86, x64, ARM) and run it to install the 
remote tools. 


Go to the Start page and launch the Remote Debugger. 


Remote 

Debugger 


If your computer’s network configuration needs to change, it may pop up a wizard to help with that. 
Once it’s running, you’ll see the Visual Studio Remote Debugging Monitor window: 



Visual Studio Remote Debugging Monitor 


n 



File Tools Help 

Date and Time Description 

f . 

Z:B7:M PM Msvsmon started a new server named 1 MY-SURFACE :4016'. Waiting for new conn. 


This is oy\ a do 叶 u 七 ev called MY^-SURFACE. Take 

o( 七 he r) 3 n\Cj because it v/ill dome m m 

3 


Your remote computer is now running the Visual Studio Remote Debugging Monitor and waiting 
for incoming connections from Visual Studio on your development machine. 


If you have an odd network setup, you may have trouble running the 
remote debugger. This MDSN page can help you get it set up: 
http://msdn.microsoft.com/en-us/library/vstudio/bt727f1t.aspx 


Flip t9 get ymr app up and running Qnthe remote computer! 


4 



you 


are here ► 
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humans saved for now 


Start remote debugging 

Once you’ve got a remote computer running the remote debugging monitor, you 
can launch the app from Visual Studio to install and run it. This will automatically 
sideload your app on the computer, and you’ll be able to run it again from the Start 
page any time you want. 



CHOOSB xV EBM^TB MACHINE，，FEm THE DBBU& 

You can use the Debug drop-down to tell the IDE to run your program on a remote 
machine. Take a close look at the 卜 Local Machine ^ button you’ve been using to run your 
program — you’ll see a drop-down ( — ). Click it to show the drop-down and choose Remote 
Machine: 



a chine ^ 


Debug ^ 


► Remote Machine 

Simulator 
Local Machine 
Remote Machine 


Po^*t -fovyt *to 七 iVis 

badk *to Sii^ula-tov youVc 

veadv *to move ov\ *to 七 

Aaf 七 evf You II be a 

pvoyaw'S, dr\d you’ll tittA 

*to v-u 於 


❹ 


EUN ON THE MACHINE. 

Now run your program by clicking the ► button. The IDE will pop up a window asking for the 
machine to run on. If it doesn’t detect it in your subnet, you can enter the machine name manually: 
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start building with c# 


o 6NTBR y^UR 6RBDBMTIAUS. 

You’ll be prompted to enter the username and 
password of the user on the remote machine. 

You can turn off authentication in the Remote 
Debugging Monitor if you want to avoid this (but 
that’s not a great idea, because then anyone can 
run programs on your machine remotely!). 


Windows Security 


ID 


Enter your credentials 

Visual Studio was unable to create a secure connection to 
MY-SURFACE:4016. Authentication failed. 

To retry, enter your credentials for MY-SURFACE. 


User name 

Password 

Domain: 

I I Remember my credentials 



OK Cancel 


You already obtained a free developer license from 
Microsoft when you installed Visual Studio. You need 
that license in order to sideload apps onto a machine. 
Luckily, the Remote Debugging Monitor will pop up a 
wizard to get it automatically. 




Microsoft Visual Studio Express 2012 for Windows 8 



O Developer license acquisition has been started on machine 

"MY-SURFACE". Please check that machine's console to complete 
developer license acquisition. 


OK 


O Nd-SAN/e sme humams/ 

Once you get through that setup, your program will start running on the 
remote machine. Since it’s sideloaded, if you want to run it again you can 
just run it from the Windows Start page. Congratulations, you’ve built your 
first Windows Store app and loaded it onto another computer! 




0 


O 


invasion force. Ml retreqt! Tbit's 
an order! TTiese EcirtJilings cire np 
pusfcoVers. We’ll need to regroup and 
replan 9nr attack. 


Co 妁 3 疒 3 七 “!3 七 iohS., You^vc 

held o-Pf the alich 

a -Pcclihg^EKa-t this 
the last wc ; vc heaved 
o( therw. 


you are here ► 
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2 it's all just coje 


# Under the hood ^ 



OKB O? THESE DAYS 
I X UU FIGURE OUT 
WHAT X S &0\U& Obi 
UMDBE THBRB— 


You’re a programmer, not just an IDE user. 

You can get a lot of work done using the IDE. But there’s only so far it 
can take you. Sure, there are a lot of repetitive tasks that you do when 
you build an application. And the IDE is great at doing those things for 
you. But working with the IDE is only the beginning. You can get your 
programs to do so much more — and writing C# code is how you do it. 
Once you get the hang of coding, there’s nothing your programs can’t do. 


this is a new chapter 



at your service 


Whew youVe doing this 


ttt 


The IDE is a powerful tool —— but that’s all it is, a tool for you to use. Every time 
you change your project or drag and drop something in the IDE, it creates code 
automatically. It’s really good at writing boilerplate code, or code that can be 
reused easily without requiring much customization. 

Let’s look at what the IDE does in a typical application development, when you’re … 


All -tKcsc -tasks Kavc -to 
do v/i*tK star\dav-d a6*tior\s 
dy\d bo'ilcvfla*tc dodc- Tliosc 
av*c *tKc -tK'mjs *bKc IPt is 
yea 七 -fov v/itiv 


❶ 



CiaBATIbJ^ A MINORS ST 從 5 P 故 J5CT 


-IN 公 

sevc 


There are several kinds of applications the IDE lets 
you build. We’ll be concentrating on Windows Store 
applications for now~you’ll learn about other kinds of 
applications in the next chapter. 

In CHap-tcv I, you 6\redicd 9 bbhk l/Vihdows S-fcovc pv-oje^t 一 

土 Wd "the IDE "to av\ empty page av\d add it 一 ^ 

"to youv* hew 


Templates 
t> JavaScript 
t Vituol Ba«c 


New Project 


Sort by： Default • ；i f |Ej 

I Blank App (XAML) 

S Grid App (XAML) 

Split App (XAML) 

Class Library (Windows Stoie apps) 
Windows Runbme Component 
j^ljj Unit Test Library (Windows Store «pp5] 


stalled Templates (Clil-*E) 


A single-page project for a Windows Store 
app that hA no pi«deTmed controls or 





C:\UsertVPublk\DocumentsWisudl Studio 2012VProjects\ 


[^] Create directory for toluiion 
□ Add lo touice control 


一 



t>J2A 站 IN 彡 A £>UT £>F THB 

T^>6>UB6>X AMO ^>NT6> Y6>UR PA&B, AMO 
THBN t>£>UBUB-CUCKIN^ IT 

Controls are how you make things happen in your page. 
In this chapter, we’ll use Button controls to explore 
various parts of the C# language. 




S5TTIN 彡 A PR^PSeTy^N Y^Ue PA 站 

The Properties window in the IDE is a really 
powerful tool that you can use to change attributes of 
just about everything in your program: all visual and 
functional properties for the controls on your page, 
and even options on your project itself. 



Thc wihdow ih ihc /DE i, ^ „ 

讲 e you U e . d e ‘ A ahd n ta 


Properties : ▼ 

33 

— Name startButton 


f 


Type Button 

Search Properties fi 

Arrange by: Category ▼ 


> Brush 

> Appearance 
a Common 

ClickMode Release 

Content Start! 

ContentTransitions (Collection) 
T oolTi pService.T ool... 
DataContext 

>/ 


□ 



New 


□ 


54 


Chapter 2 




































it’s all just code 


the 1I?E does this 


Every time you make a change in the IDE, it makes a 
change to the code, which means it changes the files that 
contain that code. Sometimes it just modifies a few lines, 
but other times it adds entire files to your project. 


O … TH5 It>6 CRBATBS THB FIUBS AMO 

THB PR^>JBCT^ 



P^dc+.hcd -tcr^p|^ c ^ 

° h Y ms basi ^ ^ode io 
a^d display a 



•csproj 



❺ … TH5 It>6 At>t>S C£>t>B T^> MAINpAC^e^XAMU THAT At>t>S A 

BUTTON, AM> TH5N At>t>S A MBTH^>t> TO MAINpAOB 
THATt^BTS SUM ANY TIMS THB BUTTON IS CUCKBt>^ 

private void startButton Click (object sender, RoutedEventArgs e) 


o 


< 阿 > 

， id> I 

</yr\d> 1 

< 々 ，> I 

MainPage.xaml 



TKc I PE- knov/s lioy/ *to add 3^ crafty wvc*t^od 

{jo ^dr>ale d button dlidk. But rt Aotsr!i kr>ov/ 
*to put msidc i*t-*tKaVs youv job. 


•••we it>e opens thb MainPa^b^xamu fiub 

AMO UPt>ATBS A LIMB XAMU 



MainPage.xaml.es 



<Button x:Name= M startButton" 

Content="Start 


TV^c IPC- v/cv^*b >v\*to 



HorizontalAlignment= n Center" 

VerticalAlignment= M Center" Click= M startButton Click"/> 


， id> I 

</yr\d> 1 

初 > J 

MainPage.xaml 


..a,a u ? aated tW.s >(_L 6 士 . 


you are here 
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great, the “talk” 


Where programs come from 

A C# program may start out as statements in a bunch of 
files, but it ends up as a program running in your computer. 
Here’s how it gets there. 


Every program starts out as source code files 

You’ve already seen how to edit a program, and how the IDE saves your program to 
files in a folder. Those files are your program — you can copy them to a new folder 
and open them up, and everything will be there: pages, resources, code, and anything 
else you added to your project. 

You can think of the IDE as a kind of fancy file editor. It automatically does the 
indenting for you, changes the colors of the keywords, matches up brackets for you, 
and even suggests what words might come next. But in the end, all the IDE does is 
edit the files that contain your program. 

The IDE bundles all of the files for your program into a solution by creating a \ 
solution (.sin) file and a folder that contains all of the other files for the program. The 
solution file has a list of the project files (which end in .esproj) in the solution, and the 
project files contain lists of all the other files associated with the program. In this 
book, you’ll be building solutions that only have one project in them, but you can 
easily add other projects to your solution using the IDE’s Solution Explorer. 



ho \redsoh you 
Aouldh^t build youv 
f\rog\rams ih hloic^d, 
but i-t^d be a lot 

"tirnc—dohSurwihg. 


Wild the program to create aw executable 

When you select Build Solution from the Build menu, the IDE compiles 
your program. It does this by running the compiler, which is a tool that 
reads your program’s source code and turns it into an executable. The 
executable is a file on your disk that ends in .exe — that’s the actual program 
that Windows runs. When you build the program, it creates the executable 
inside the bin folder, which is inside the project folder. When you publish 
your solution, it copies the executable (and any other files necessary) into 
into a package that can be uploaded to the Windows Store or sideloaded. 



When you select Start Debugging from the Debug menu, the IDE compiles 
your program and runs the executable. It’s got some more advanced tools 
for debugging your program, which just means running it and being able 
to pause (or “break”）it so you can figure out what’s going on. 
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it’s all just code 


The .NET Framework gives you the right tools for the job 

C# is just a language —— by itself, it can’t actually do anything. And that’s where the .NET 
Framework comes in. Those controls you dragged out of the toolbox? Those are all part of 
a library of tools, classes, methods, and other useful things. It’s got visual tools like the XAML 
toolbox controls you used, and other useful things like the DispatcherTimer that made your 
Save the Humans game work. 


All of the controls you used are part of .NET for Windows Store apps, which contains 
an API with grids, buttons, pages, and other tools for building Windows Store apps. But for 
a few chapters starting with Chapter 3, you’ll learn all about writing desktop applications, 
which are built using tools from the .NET for Windows Desktop (which some people call 
“WinForms”). It’s got tools to build desktop applications from windows that hold forms with 
checkboxes, buttons, and lists. It can draw graphics, read and write files, manage collections 
of things.. .all sorts of tools for a lot of jobs that programmers have to do every day. The 
funny thing is that Windows Store apps need to do those things, too! One of the things 
you’ll learn by the end of this book is how Windows Store and Windows Desktop apps do 
some of those things differently. That’s the kind of insight and understanding that helps good 
programmers become great programmers. 


The tools in both the Windows Runtime and the .NET Framework are divided up into 
namespaces. You’ve seen these namespaces before, at the top of your code in the “using” lines. 
One namespace is called Windows . UI. Xaml. Conrols — it’s where your buttons, checkboxes, 
and other controls come from. Whenever you create a new Windows Store project, the IDE will 
add the necessary files so that your project contains a page, and those files have the line “using 
Windows . UI. Xaml. Controls at the top. 


篆 

API ； o\r Appl.^tio 的 

Pv-ojvarwm'mg is 

d dollcdtio^ CoAt "tools 
七 hat you use b> 366ess 
or do^-tvol 3 sysiem. 

systems have APk 

but thcyVc especially 
irwpov-ta^-t (or opev-atmj 
svs-tci^s like W\y\do^s. 


You can see an overview of .NET for Windows Store apps here: 
http://msdn.microsoft.com/en-us/library/windows/apps/br230302.aspx 




Your program runs inside the Common Language Runtime 

Every program in Windows 8 runs on an architecture called the Windows Runtime. But 
there’s an extra “layer” between the Windows Runtime and your program called the 
Common Language Runtime, or CLR. Once upon a time, not so long ago (but before 
C# was around), writing programs was harder, because you had to deal with hardware and 
low-level machine stuff. You never knew exactly how someone was going to configure his 
computer. The CLR —— often referred to as a virtual machine —— takes care of all that for ? 
you by doing a sort of “translation” between your program and the computer running it. ^ n ^ ^ ^ ^ 

You’ll learn about all sorts of things the CLR does for you. For example, it tightly manages 止 。以七七 CL-R 圹吵七 
your computer’s memory by figuring out when your program is finished with certain pieces | 七’ s aou# *to knov/ » 七 s 

of data and getting rid of them for you. That’s something programmers used to have to do 杜州 , "bakes 
themselves, and it’s something that you don’t have to be bothered with. You won’t know it y G ur -fov you 

at the time, but the CLR will make your job of learning C# a whole lot easier. au'tomattally- mov-c 

dkou*b >*t 3s 3°* 


you are here ► 
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mothers little helper 


The IPE helps you code 

You’ve already seen many of the things that the IDE can do. 

Let’s take a closer look at some of the tools it gives you, to 
make sure you’re starting off with all the tools you need. 

O THB S^IAJTI^N SH^>VJS YOU BVBIZYTHIN^ 

IN YOUJZ PROJECT 

You’ll spend a lot of time going back and forth between classes, and the easiest 
way to do that is to use the Solution Explorer. Here’s what the Solution Explorer 
looked like after creating a blank app called Appl: 


The Solutioh 
Explo\rc\r 
shov/s you the 
di-P^C\rCht -Piles 
•… the solu'tioh 
-Poldcv-. 


Solytion Bcpbrer 


ts 亡 -# q a 阍 <> > p 


j 


Search Solution Explorer [Ctrl+;] 

Solution 'AppV [1 project) 

回 Appl 

> ^ Properties 

References 
ii Assets 
_ Common 
fji App.x-aml 

p3 Ap p 1 _T ern p □ ra ryKey . pfx 


ainPage.xamil 


Package, appxmanifest 


> 

> 

> 

> 



- 平 X 


P- 


O use THB TABS TO SWITCH B5TUJ55N OPBN FlUBS 

Since your program is split up into more than one file, you’ll usually have several 
code files open at once. When you do, each one will be in its own tab in the code 
editor. The IDE displays an asterisk (*) next to a filename if it hasn’t been saved yet. 


o ▼ ® ffl y ^ 9 


Local Machine ^ Debug ▼ Any CPU 


MainPage.xaml 



ge.xaml.es 



youVc 滅 km” “ you H ^ 

tabs U at same a^d 

to V.CV/ codt. Use Co^ol^Tab to 妯仉 kW ⑶ 

opc^ y/mdows ^uitklV- 
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it’s all just code 


o 


n rwissmg 
semidoloh 
the tt\A o( d 
s-fccl-tcrwCh-t is 
ov\t o( the most 
£.ommor) c\r\ro\rs 
that keeps youv- 
p\rog\rarw -f\rorw 

buildup. 


THB It>6 HBUPS YOU VJJZITB COt>B 

Did you notice little windows popping up as you typed code into the IDE? That’s 
a feature called IntelliSense, and it’s really useful. One thing it does is show you 
possible ways to complete your current line of code. If you type random and then a 
period, it knows that there are three valid ways to complete that line: 


random :」 


® Equals 
© GetH ash Code 
© GetType 
© 

© NextByte& 

® NextDouble 
© ToString 



int Random-Nedfint minValue, int maxValue] [+ 2 overloadCs)) 
Returns a random number within a specified range. 

Exceptions: 

System .Argum entO utOfRang eExc eption 


The IDE khows that \rdhdom 

has methods H, NcxtBytcs, 
Ko^tDoublc, -fouv othevs. |-f you 
type K it selects Kcxt. Type 'V 

oV * s P a 把 o\r Ehtcv- -fco tell the 

IDE io ^.11 \i m 4v- you. Th^ 
be a \rcal -tirwcsavc\r \\ youVc typing 
a lo-t o-P veally method hames. 


random.Wext 


2 of 3 T int Random.NedfEnt maxValue) 

Returns a nonnegative random number less than the specified maximum. 

处 oxVafue: The exdusii/e upper bound of the random number to be generated. moxVoive must be grea ter than or equal to zero. 

This mea^s that -thcv-c arc i diWcv-c^*t ways that 
you tBY\ ^all Random.method. 

If you select Next and type (, the IDE’s IntelliSense will show you information 
about how you can complete the line. 

VVV\cv\ you use i\\t -to 


/ouv 


ths list hslps you moueuss^oor 

CO/^PIUBR B1212^12S 

If you haven’t already discovered how easy it is to make typos in a C# 
program, you’ll find out very soon! Luckily, the IDE gives you a great tool for 
troubleshooting them. When you build your solution, any problems that keep it 
from compiling will show up in the Error List window at the bottom of the IDE: 


yrun Vowr ^v-am ms«dc ^ P » 

七 kLUWm …七 docs \sMd 

Y 祕 y 呼 am. H 七 6 。听， f 本 

七 70 收 V^s. I^r wot, 

Vt v/o^-t vuv,, a^a W.H sV^ov/ 70 U 

cyrvoyrs m *t^c tvvov L\st 



Error List 






T ▼ O 2 Errors 



Search Error List 

P ， 

Description 

File a 

Line ▲ 

Colu... 

▲ Project ▲ 








O 2 'System.Random' does not contain a definition for 'Nxet' and no extension method 'Nxet' accepting a first 

MainPage.xaml.cs 

30 

20 

Appl 



argument of type 'System.Random' could be found (are you missing a using directive or an assembly reference?) 

Error List Output 

Double-click on an error, and the IDE will jump to the problem in the code: 

The IDE v/ill show d s^ui^ly 
u^devsdove -fco show you ihai 


int 


r a ndom.Next ( 1 ®) 



; expected "thcv*c s C\rv*o\r. Hovcv* ovcv* i*t 
"to see the sarwc cv-vov* message 
七 ha 七 appeavs m ihc Evv-ov List 


you are here ► 
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your program makes a statement 


Anatomy of a program 

Every C# program’s code is structured in exactly the 
same way. All programs use namespaces, classes, 
and methods to make your code easier to manage. 

A tlass to^-bams a ，你 

? v-o^a^ (al-tv^ou^ some vc^ry 加 all 

p 哼加 jus 七 one t\assl 


A has ot\t oy move methods. 
Y<>[A\r methods always have -to live 
i nside 3 ^bss. / methods avc 
r^adc up ol' s-tatcmchts—like ihe^ 
emes you ; vc already seev\. 


Let's take a closer look at your code 

Open up the code from your Save the Humans project’s 
MainPage.xaml.es so we can have a closer look at it. 


He Ad 


NAM 6 SPAC 6 





6UASS 


MBTH^>t> 1 

STATBMBNT 

STAT5M5NT 

A(e 77 *P£> 2 

STATBMBNT 

STATBMBNT 



The ovdev- of -the 
methods \ y \ -the 

dlass -Pile doeWi 
rncihod 
2 - ddh just as 
easily 

bc-fo\rc rwethod I. 



me cov>e fiub starts byusin^ tub -nst fizamb^izic tools 

You’ll find a set of using lines at the top of every program file. They tell C# which parts of the 
.NET Framework or Windows Store API to use. If you use other classes that are in other namespaces, 
then you’ll add using lines for them, too. Since apps often use a lot of different tools from the .NET 
Framework and Windows Store API, the IDE automatically adds a bunch of using lines when it 
creates a page (which isn’t quite as “blank” as it appeared) and adds it to your project. 


using System; 

using System.Collections.Generic; 
using System.10; 
using System.Linq; 
using Windows.Foundation; 
using Windows.Foundation.Collections 
using Windows.Ul.xaml; j 

One thing to keep in mind: you don’t actually have to use a using statement. You can always use 



丁卜 usih 9 li^CS a\rc si -the -top 
°y v ^y ^odt -Pile. They tell 
C# -to use all <^P those ./s/ET 
F\ramcwo\rk classes. Ba^h -tells 
you\r that the classes 

.ds ^i| c will use 

all J the classes ih OhC spedi-fid 

■HBT Fv-arncwov-k (System) 


the fully qualified name. Back in your Save the Humans app, you added this line: 

using Windows.UI•Xaml.Media.Animation; 


Try commenting out that line by adding / / in front of it, then have a look at the errors that show 
up in the error list. You can make one of them go away. Find a Storyboard that the IDE now tells 
you has an error, and change it to Windows . UI • Xaml. Media . Animation. Storyboard (but you 
should undo the comment you added to make your program work again). 
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❺ 


it’s all Just code 


Cn P12^12AMS A12B 0 故 ANIZ50 INTO CLASSES 

Every C# program is organized into classes. A class can do anything, but most classes 
do one specific thing. When you created the new program, the IDE added a class called 
Main Page that displays the page. 


namespace Save 


the Humans 



you tailed you\r ^oyra^ Save the the IDE dv-catcd a 

Mmespade *fo\r i 七 Edited fturwa^s (i-t do^vcirtcd the spades 

■to uhdc\rsdo\rcs because ^arwcspatcs da〆 七 have spades) by addmg -the 
^arwespate kcyv/oird ai -the -top o( youv todt -Pile. Evcvy-thmg mside its 
^ o( ^u\rly biradkcis is part o( ihc Save 


pai\r 


Look -Po\r -the 
pdi\rs 

of bv-a^kets. 
Evc\ry { is 
cvc^-tually 
paired up with 
d J- Sonrte 
paiv-s c^v\ be 
inside o-thev-s. 


■ihc^tturwa^s 灼 amespade. 

public sealed partial class MainPage : Page 

^ This is a dlass dalled /l/Ia'mPa^c- l*t 丄 s all 七 he todt *to make 七 he >wovk. The 

IDE dvea-ted i*t v/hcr> you -told i*t *to ertait a r>c>w bUk C# iVmdov/s £*torc f^rojedi 

CUASSBS CONTAIN MBTH£>t>S THAT PB12F^]2M ACTIONS 

When a class needs to do something, it uses a method. A method takes input, performs some 
action, and sometimes produces an output. The way you pass input into a method is by using 
parameters. Methods can behave differently depending on what input they’re given. Some 
methods produce output. When they do, it’s called a return value. If you see the keyword 
void in front of a method, that means it doesn’t return anything. 

void startButton 一 Click (object sender, object 

丁 method 



StartGame() 


A STAT5M5NT PBIZF^IZMS ObiB 5 膨彡 5 ACTION 

When you filled in the StartGame () method, you added a bunch of statements. Every 
method is made up of statements. When your program calls a method, it executes the first 
statement in the method, then the next, then the next, etc. When the method runs out of 
statements or hits a return statement, it ends, and the program resumes after the statement 



This Imc dalls a mrthod earned 

y/hidh *thc IDE 

helped you Cctdkt you 

asked ii b> add a rwrthod stub. 


V^as W 


taWcd 

ar^d c - 


that originally called the method. 

private void StartGame() <^- 


TW,S \S -bv.c r^c^od called ! 七 3 七户 


human.IsHitTestVisible = 
humanCaptured = false; 
progressBar.Value = 0; 
startButton.Visibility = 

Visibility.Collapsed; 
playArea.Children.Clear(); 
playArea.Children.Add(target); 
playArea.Children.Add(human); 
enemyTimer•Start(); 
targetTimer.Start(); 


true ; 

TKc £*tav*t^amcO mc*tKod do^*ta'ms 
Y\\y\t ⑼七 s. Eadh 

er^ds wi*th a semidolorv 


/*ts OJs -fco add cx-fcv-a 
Ibreaks -to make 

y° u,r move 

readable. ThcyVc ighoved 

when youir pvogvam builds. 


ttcv-c^s -the dlosm^ b\radkc*t a*t the vc\ry 
bo*t*tom youv- Ma'mPajc-file- 


you are here 
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get some answers 




tWeiqre no o 

Dumb Questions 


What’s with all the curly brackets? 


C# uses curly brackets (or “braces”）to group statements 
together into blocks. Curly brackets always come in pairs. You'll 
only see a closing curly bracket after you see an opening one. The 
IDE helps you match up curly brackets—just click on one, and you’ll 
see it and its match get shaded darker. 


How come I get errors in the Error List window when I try 
to run my program? I thought that only happened when I did 
“Build Solution.” 

Because the first thing that happens when you choose Start 
Debugging from the menu or press the toolbar button to start your 
program running is that it saves all the files in your solution and then 
tries to compile them. And when you compile your code—whether 
it’s when you run it, or when you build the solution—if there are 
errors, the IDE will display them in the Error List instead of running 
your program. 


A lot o-p the cv-\ro\rs that show up whch you tv-y -fco v-uh 
youir p\rog\ram also show up \y\ the E\r\rov- List window 
a^d as \rcd s^uigglcs uhdev- youv- todc 



SO TH6 ID6 6ANJ 126AUUY 
H6UP M6 OUT. XT ^6NJ612AT6S 
COl>B, AMD IT ALSO H6UPS MB FIND 
P12^BU6MS IN MY COt>B^ 


The IDE helps you build your code right. 

A long time ago, programmers had to use simple text 
editors like Notepad to edit their code. (In fact, they would 
have been envious of some of the features of Notepad, like 
search and replace or A G for “go to line number.’’）We had 
to use a lot of complex command-line applications to build, 
run, debug, and deploy our code. 

Over the years, Microsoft (and, let’s be fair, a lot of other 
companies, and a lot of individual developers) figured out 
a lot of helpful things like error highlighting, IntelliSense, 
WYSIWYG click-and-drag page editing, automatic code 
generation, and many other features. 

After years of evolution, Visual Studio is now one of the 
most advanced code-editing tools ever built. And lucky for 
you, it’s also a great tool for learning and exploring C# and 
app development. 
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it’s all just code 


Match each of these fragments of code generated by the IDE to what it does. 
(Some of these are new — take a guess and see if you got it right!) 


myGrid.Background = 

new SolidColorBrush(Colors.Violet); 


Set properties for a TextBlock control 


Nothing — it’s a comment that the 

// This loop gets executed three times programmer added to explain the code 

to anyone who’s reading it 


Disable the maximize icon (fal) in the 
title bar of the Forml window 


public sealed partial class MainPage : Page 
{ 

private void 工 nitializeComponent() 



helloLabel.Text = "hi there"; L 

helloLabel.Fontsize = 24 ； I A special kind of comment that the IDE 

uses to explain what an entire block of 
code does 


III <summary> 

III Bring up the picture of Rover when 
III the button is clicked 
III </ summary> 


Change the background color of a Grid 
control named myGrid 


partial class Forml 


this.MaximizeBox = 


false; 


A method that executes whenever a 
program displays its main page 


you are here ► 
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exercise solution 


% 


♦ 




• + 


Match each of these fragments of code generated by the IDE to what it does. 
(Some of these are new — take a guess and see if you got it right!) 


myGrid.Background = 

new SolidColorBrush(Colors.Violet); 


// This loop gets executed three times 



public sealed partial class MainPage : Page 


private void 工 nitializeComponent () 


helloLabel.Text = "hi there"; 
helloLabel.FontSize = 24; 


III <summary> 

III Bring up the picture of Rover when 
III the button is clicked 
III </ summary> 


partial class Forml 


this.MaximizeBox = false 


Set properties for a TextBlock control 



Nothing — it’s a comment that the 
programmer added to explain the code 
to anyone who’s reading it 


Disable the maximize icon in the 
title bar of the Forml window 


a y/mdoy/? Not a pay? 
You’ll start Ica\nr>'m5 about 

dcsk*tof apps W\{}\ y/mdov/s 扣 d 
■fovi^s l3*tcv" \v\ 七 iiis 

A special kind of comment that the IDE 
uses to explain what an entire block of 
code does 


Change the background color of a Grid 
control named myGrid 


A method that executes whenever a 
program displays its main page 
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it’s all just code 


Two classes can be m the 
same namespace 

Take a look at these two class files from a 
program called PetFiler2. They’ve got 
three classes: a Dog class, a Cat class, and 
a Fish class. Since they’re all in the same 
PetFiler2 namespace, statements in the 
Dog. Bark () method can call Cat. Meow () 
and Fish . Swim () . It doesn’t matter how 
the various namespaces and classes are divided 
up between files. They still act the same when 
they’re run. 


SomeClasses.es 


㈧ 一 a 
七 


MoreClasses.es 




SiMe "these classes amc'm the same 
they all “see" cadh o-thev-—cvcr> -though 
thcyVc m di-P-Pcvchi -files. dlass cav\ span 
rwultiplc -files -too, but you heed "to use the 
Ya\rtial ； kcyv/o\rd when you Atc\^rt it 

u 匕扣 only spli 七 a class up m-fco di-P-Pcvc^t -files 
i-f you use the w pa\rtiar keyword. You fvobably 
y/or^'i do thai *m arNof ihc Code you v/viic m 
•tliis book ； bu*t "the II)E used i*t "to spirt youv 
up m-to iv/o -files so ii dould fui the 
)^AML- todt m-to /l/la'mPajcocarwl ar>d -the 
toAt nrto /Wa’mPay.xamUs. 


There’s more to namespaces and class declarations, but you 
won’t need them for the work you’re doing right now. Flip to #3 
in the “Leftovers” appendix to read more. 


you are here ► 
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your mileage may vary 


Your programs use variables to work with data 


When you get right down to it, every program is basically a data cruncher. 
Sometimes the data is in the form of a document, or an image in a 
video game, or an instant message. But it’s all just data. And that’s where 
variables come in. A variable is what your program uses to store data. 


Peclare your variables 

Whenever you declare a variable, you tell your program its type and its name. 
Once C# knows your variable’s type, it’ll keep your program from compiling 
if you make a mistake and try to do something that doesn’t make sense, like 
subtract “Fido” from 48353. 


y^0\t ^ 


These 


^ o+ t hcsc v ^ i3blcs 

int maxWeight; 
string message; 
bool boxChecked 




^ak\cs hold. 


咖 CS 減 mak 义 c “ 


Variables vary 

A variable is equal to different values at different times while your 
program runs. In other words, a variable’s value varies. (Which is 
why “variable” is such a good name.) This is really important, because 
that idea is at the core of every program that you’ve written or will ever 
write. So if your program sets the variable myHeight equal to 63: 

int myHeight = 63; 

any time myHeight appears in the code, C# will replace it with its 
value, 63. Then, later on, if you change its value to 12: 

myHeight = 12; 

C# will replace myHeight with 12 —— but the variable is still called 
myHeight. 


Are you 
already 
familiar with 
another 
language? 

If so, you might find that a 
few things in this chapter 
seem really familiar. Still, it’s 
worth taking the time to run 
through the exercises anyway, 
because there may be a few 
ways that C# is different from 
what you’re used to. 



Watch it! 


Wkenever your 


program needs to 
work witk numters, 
text, true/false 


er 


values, or any otk 
kind oi data ， you’ll 


use variatles to keep 
track ol them. 
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it’s all just code 


You have to assign values to variables 
before you use them 

Try putting these statements into a C# program: 


string z; 
string message 


'The answer is 


z ； 


Go ahead, give it a shot. You’ll get an error, and the IDE will 
refuse to compile your code. That’s because the compiler 
checks each variable to make sure that you’ve assigned it a 
value before you use it. The easiest way to make sure you 
don’t forget to assign your variables values is to combine 
the statement that declares a variable with a statement that 
assigns its value: 


int maxWeight = 25000 
string message 
bool boxChecked 



TVicsc values 
avc ass'i^cd *to 
variables. 


Bsdr) dedlav-aiio^ has a -type, 

c^ad-tly like bc-Pov 


>\rc. 


A few useful types 


Every variable has a type that tells C# what kind of data it can 
hold. We’ll go into a lot of detail about the many different types 
in C# in Chapter 4. In the meantime, we’ll concentrate on the 
three most popular types, int holds integers (or whole numbers) 
string holds text, and bool holds Boolean true/false values. 


var - i_a_ble, noun. 

an element or feature likely to change. 

Predicting the weather would be a whole lot 
easier if meterologists didn’t have to take so 
man y variables into account. 


If you write cocte 
tkat uses a variable 
tkat liasn’t Leen 
assigned a value, 
your code won’t 
compile* It’s easy to 
avoid tkat error 
Ly coititining your 
variable cteclaration 
and assignment into 
a single statement. 


f ^ y° u vc a value 
to yowr variable, ihai value 

， So ho 

d'ssdva^ ^ assi ^ 
斷 1 十 ' ih 如 I value y/hch 

you dc^ 3 \rc it 


you are here ► 
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operators are standing by 


C # uses familiar math symbols 


Once you’ve got some data stored in a variable, what can you 
do with it? Well, if it’s a number, you’ll probably want to add, 
subtract, multiply, or divide it. And that’s where operators come 
in. You already know the basic ones. Let’s talk about a few more. 
Here’s a block of code that uses operators to do some simple math: 


To programmers, the 
word “string” almost 
always means a string of 
text, and “int” is almost 
always short for integer. 


Wc dc^lavcd a 於如 

•m 七 variable tailed 
ytuw'bcv* Sft i 七七 o 
I 弓 . Then v/e added \0 
{jo it A-f-bcv- i\\t second 
r\umbcv is 

c«\ual *to 2- 1 ?. 


int number 
number = 
number = 



The thiv-d statemejrrt -the 

value o( ^umbev-, srttma i-t c^ual h> 
弘 times l^, v/hidh is $4*0. 丁 i 七 
v-cscts it ay m, srttmg i*t e<\ual bo 
I2» —( 午 Z / 7), v/hi 乙 li is 厶 . 


The 决二 opeva-tov 
is similar -to , / 

i*t mul-tiplies 
"the 匕 uv\reivt value 
灼 umbe\r by so i 七 

ends up se*t "to 午 


number += 10; 
number *= 3; 
number =71/3 


TKis of 饮 a*tov k a Irbtle 忧七 . 

+ 二 medr>s -take 七 he value o( ^umbev 
a^d add 10 b> it Si^dc number is 
duvvcr>*tly c«\ual *to ^ add*m^ 10 *to i 七 
sc*ts i*ts value *to 1^- 


Normally, 71 divided by Z is g u *t y/b youVc 

\ ♦ dividmj two \v\U, you'll always jet av\ mt result, so 23>Ml> … 


This sets *thc 
do^-tc^*b o( a 
Ic^tBlodk doivbrol 
ou*tf u 七 *to 
\t\\o a^dm Ml。”. 


int count = 0; 
count ++; 
count 


you 

jets -tv-uhdated {p Z 孓 



yi>u II use \y\i d lot -fov douirvtm 少 y/Kcr^ you do, i\\t ++ 

d 灼 d —一 opcv 3 *toVS dome \Y\ ++ mdvcrwcv>'ts dou 灼七 

by addm^ or>c *to *tKc value ； ar\d 一 - dctvcmc^*ts doun*t by 
sub*tvadtmg oy\C -fvom *i*t> so i*t tv\As up c<\ual *to z^evo. 


The …’ 孙⑽由士 
I 七 V^s no eMaracitrs. result 

(|Vs krnd like a^o 

Uaaa^sW.)V^ result 


string result = "hello"; 
result += ▼▼ again ▼▼ + result; ^ 
output.Text = result; 


you use the + opeva-tov 
y/i*th 3 s*brm$ i 七 jus-t fu*U 
*tv/o s-tv-'mjs -toythev-. Itll 


au*toma*tidally do^vcv-*t 
” the value is: ” + count; ^ um bm io sVm 5 s U you. 


If If 


A bool s-fcoves *t\ruc 
ov- -false- The ! 

opc\ra*bo\r n\e3r\S MOT- 

I 七 -flips *t\ruc h> 

-false, a^d vi^c vcv-sa. 


bool yesNo = false; 
bool anotherBool = true; 


yesNo = !anotherBool; 


o 



Don’t worry about 
memorizing these 
operators now. 


because you’ll 


You’ll get to know them 
see ’em over and over again. 
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it’s all just code 


Use the debugger to see your variables change 

The debugger is a great tool for understanding how your programs 
work. You can use it to see the code on the previous page in action. 



❶ CBBATB A MB\d VISUAL CU ST^RB 8LAMK APP (XAMU) Pja^JBCT^ 

Drag a TextBlock onto your page and give it the name output. Then add a Button and double-click it 
to add a method called Button—Click () • The IDE will automatically open that method in the code 
editor. Enter all of the code on the previous page into the method. 


餐 


Q IMSBRTA BRBAKP^IMT THB FIRST LIMB 

Right-click on the first line of code (int number = 15;) and choose Insert Breakpoint from the 
Breakpoint menu. (You can also click on it and choose Debug—Toggle Breakpoint or press F9.) 


Chapter 2 - Program 1 


_ □ X 

▼ 

5 Chapter_2_Program_1.MainPage 

▼❺* OnNavigatedTo(NavigationEventArgs e) 

▼ 


B 


150 % 


+ 


/* Double-clicking on the Button in the designer caused it to 
* create the empty Button 一 Click() method. 

V 


private void Button_Click( object sender. RoutedEventArgs e) 

// There's a breakpoint on this line 


int number 


10 


number = number _ 
number = 36 * 15; 
number = 12 - (42/7) 
number += 10; 
number *= 3; 
number =71/3; 




int count 
count++; 
count--: 


0： 


o^odc -the li, c W ,ed a,d a 

二 d dot i, -the 心 J 

the todt edrtov\ 


y° u debug youv- udt by 

〜 it ihsidf -/-V /r>P J 


string result = "hello"; 
result += " again •• + result; 

output• Text = result; it ihside the /PE as 

result = "the value is: " + count; sooh as youv- hrts a 

PeSUlt = ，，，，； b^kpoi,-t itll p, usc H 

bool yesNo = false; all the va^tblcT^ ^ 

bool anotherBool = true; 

yesNo = !anotherBool; 


JO 




Cow'W'Cy\*ts 

t\i\\cr slav-t … 狀七 w 
ov- 州 ove slashes or av-c 
by / 决办 d 

氺 / mav-ks) sV^ov/ u\> 

m i\\t IPt as yrtt^ 

七 o 七 .do 灼七 have 
{p y/ov^y about 一 a 七 
You typ m kc*b^cc^ 
-t^osc ma^rks, bctausc 

i^ov-cd by *tV^c tomf'ilcv-. 


Creating a new 
Blank App project 
will tell the IDE 
to create a new 
project with a blank 
page. You might 
want to name it 
something like 
UseTheDebugger 
(to match the 
header of this 
page). You’ll be 
building a whole 
lot of programs 
throughout the 
book, and you may 
want to go back to 
them later. 


► Flip the pa^e andWp ^oin^! 


you are here ► 
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stop bugging me! 


o 


o 


❹ 


o 


START YOUR PB 必 I2AM- 

Run your program in the debugger by clicking the Start Debugging 
button (or by pressing F5, or by choosing Debug—Start Debugging from 
the menu). Your program should start up as usual and display the page. 

CUCK THB BUTTON T^> THB BRBAKP^IbJT^ 

As soon as your program gets to the line of code that has the breakpoint, 
the IDE automatically brings up the code editor and highlights the 
current line of code in yellow. 




int number = 

15 i 

number = 

number + 1 ❺； 

number = 

36 * 

15; 

number = 

12 - 

(42/7) 

number +: 

= 1 @； 


number *= 

= 3; 


number = 

71 / 

3； 


-IDE Tip: SS+D 

When you’re debugging a 
Windows Store app, you can 
return to the debugger by 
pressing the Windows logo 
key+D. If you’re using a touch 
screen, swipe from the left 
edge of the screen to the 
right. Then you can pause or 
stop the debugger using the 
Debug toolbar or menu items. 


At>t> A WIATCH FOR THB number VARIABLE^ 

Right-click on the number variable (any occurrence of it will do!) and 
choose ^ Add Watch from the menu. The Watch window should appear in 
the panel at the bottom of the IDE: 



Name 


Value 


Type 


number 


Locals Watch 1 

STBP THBOU 糾 THB COV>B^ 

Press F10 to step through the code. (You can also choose Debug—Step Over from 
the menu, or click the Step Over button in the Debug toolbar.) The current line 
of code will be executed, setting the value of number to 15. The next line of 
code will then be highlighted in yellow, and the Watch window will be updated: 


As sooh as -the number 
variable jets a 

value (l^), its y/a-tdh is 

updated- 



Name 

Value 

Type 


a 

number 

15 

EFIif 




Locals Watch 1 


❹ C^NTIbJUB RUNNING THB Pe 咖 BAM- 

When you want to resume, just press F5 (or Debug—Continue)，and the 
program will resume running as usual. 
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Actcting a 
watcli can kelp 
you keep track 
ol tke values oi 
tke variables in 
your program. 
Tkis will really 
come in kancty 
wken your 
programs gfet 
more complex. 


>u also hovcir ovcir d 
variable y/hilc youVc 
"to see its value displayed m 
a 七 ool 七 ip.“and you dan pm 
i 七 so it stays 




















it’s all just code 


Loops perform aw action over and over 


Here’s a peculiar thing about most large programs: they almost always 


involve doing certain things over and over again. And that’s what 
loops are for —— they tell your program to keep executing a certain set 
of statements as long as some condition is(^rue (or f alse!).^) 




TV^aVs a ?art : W/ 

Boolean avc so imfoviayvt. 

/\ |oo^> uses a itsi 

七 should kcc? I 。。? 崎 



If your brackets (or braces —— either name 
will do) don’t match up, your program 
won’t build, which leads to frustrating 
bugs. Luckily, the IDE can help with this! 
Put your cursor on a bracket, and the 
IDE highlights its match: 

bool test = true; 

while (test == true) 

{ 

// Contents of the loop 


while loop, all of -the 
V statcmch-ts ihsidc the duvly 
get eluted as 
loh^ as the ^ohditioh \y\ -the 
fa\rChthcscs is tv-uc. 


Evcv-y -Pov loop has thv-cc s-ta*tcmc^*b. The -fiv-s*t sc*b 
uf the loop. It will keef loofiM as I 。％ as the seto^d 
is tv-uc. the thiv-d s*ta*tcmc^*t yb 
cx-cdu'tcd a-Ptcv tBt\) time the loop. 



for (int i = 0; i < 8; i = i + 2) 


// Everything between these brackets 
// is executed 4 times 


Use a code snippet to write simple for loops 

You’ll be typing for loops in just a minute, and the IDE can help 
speed up your coding a little. Type for followed by two tabs, 
and the IDE will automatically insert code for you. If you type 
a new variable, it’ll automatically update the rest of the snippet. 
Press Tab again, and the cursor will jump to the length. 


l-f you *tiic vaviablc b> 

clsc> the snippet 
au-tomatidally 

o*tiicv *t>WO odduv-vcir>dcs o( l*t- 


for (int i 

{ 

} 




Tab ^ the duvsov 
■to jump -to -the Ichjih. The 

o-P tiroes this loop vuhS 
IS by y/ha-tcvcv" 

y° u length io. /ou tayy 

Ich^th "to a humbev* ov- s 

vaviablc. 


il < 1 ength 



you are here ► 
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on one condition 


if/else statements make decisions 


Use if/else statements to tell your program to do certain 
things only when the conditions you set up are (or aren’t) 
true. A lot of if/else statements check if two things are equal. 
That’s when you use the == operator. That’s different from the 
single equals sign (=) operator, which you use to set a value. 


string message 


If If 



$叫 \( staW ⑼ t 

to 於 dvb 。 灼 al "td 


message = "The value was 24 •” 


} 




TV^c staW ⑼七 •… s ’心 
i\st ^kcts is 

-test *»s *brue. 




i-f/cUc s*ba*tcwcv>*U 3v-c 
wt 七 7 s 七 \ra 吵七心 ㉞ rd. 
|*f 七 he toy\d>tiov>al 

七 cs 七 is *tv-uc, *b^c 

c>cctu*bcs "bV>c 

staWc^b fecWcv' ^ 
^Wsi set Watkcts. 
0*t^CV"WlSC, »*t c^ctutcs 

七 he staWyrb fecW ⑼ 
七 he scC.oy\d sc 七 . 


if (someValue 



// You can have as many statements 
// as you want inside the brackets 


message 


"The value was 24 


else 



message 


▼▼The value wasn^t 24 



Don’t confuse the two equals sign operators! 

You use one equals sign (=) to set a variable’s value, but two equals 
signs (==) to compare two variables. You won’t believe how many bugs in 
programs — even ones made by experienced programmers! — are caused 


by using = instead of ==. If you see the IDE complain that you ''cannot implicitly 
convert type 'inf to 'bool 1 , that’s probably what happened. 
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it’s all just code 


/Vlake suvc you dhoose d sensible -Poir "this pirojcdt 
because youll \rc-Pcv badk -fco it latcv *m the book. 

i 

Puild aw app from the ground up 


]/At^ vou see t^ese sy^cakcvs, 
wC a^s -bV^at *twc U you -to 
tome U ? codt oy> 70 UV o^. 


The real work of any program is in its statements. You’ve already seen how statements fit into 
a page. Now let’s really dig into a program so you can understand every line of code. Start by 

creating a new Visual C# Windows Store Blank App project. This time, instead of deleting 
the MainPage.xaml file created by the Blank App template, use the IDE to modify it by adding three 
rows and two columns to the grid, then adding four Button controls and a TextBlock to the cells. 

The page has a grid with three rows 
and two columns. Each row definition 
has its height set to 1 女 ， which gives 



RciSe 


it a <RowDef inition/> without any 
properties. The column heights work the 

same way. 


The page has four Button controls, one in 
each row. Use the Content property to 
set their text to Show a message . If/else , 
Another conditional test and A loop. 



MainPage.xaml X 


Show 

r a message 







Another conditional test 


If/else 


bu-t*toh is dch-tcv-cd \ y \ the dell- Use -the 
今 irid.Row 扣 d 今 vid.Colunrm piropev* 七 ies 七 0 se 七 
the vow Bv\d dolunrm (-they dc-Paul-b "to O). 

1 A loop I 


^/ou see but *thcvVs ad:ually a 

ToctBlo^k do^tv-ol. |*t have a^y so •rt’s 

mvisible- |*t’s a^d m the bottom row, v/ith 

ColuwmSf 扣 sc*t *to Z so i 七 spa^s both dolum^s. 




92.06% ， [K!l|ai ^1 4 
Cl Design U E3 XAML d 



COBS 


The bottom cell has a TextBlock control 
named myLabel. Use its Style property 
to set the style to BodyText Style. 

l-f you wed *to use -the Edit S*tylc V-ijh-t-mousc *to 
set this bu*t youVc havm^ tv-oublc sclcdt'mj the do^*t\rol, 

fo\A t^Y\ v-igh*t-dlidk OY\ the Tc^-tBlodk doi^*t\rol m *thc 

>odum 伙七 Ou-klme By\A (Moose Edit Style -from there. 


Use the x : Name property to name the buttons 

buttonl,button2, button3, and button4. 

Once they’re named, double-click on each of 
them to add an event handler method. 


yoi 


you are here 


















ready, set, code! 



Hcvc's ouv solution *to tv^c c%c\r6sc. Poes 
广 \jo\aY solution look s'lmilsv*? "bV^C li^C 
{UflSd ^eaks di-fW^t OV- rn a 

§PL]MtiPH di-f-fcvcr\*t ovdcv"? l-f ^O) tKats 0^. 


A lot of programmers don’t use the 
IDE to create their XAML — they build 
it by hand. If we asked you to type in 
the XAML by hand instead of using 
the IDE, would you be able to do it? 




k : C l3F^-"Ch3 pter_S:___Prcijgr?fP_2 , H^inPg^e" 

iiMilfl &= N http;mlcros^ift, toit/wiiify/ 4 
wnln 5 ： : K_’htt f : ^'/sch€tna-6 - _icr^soft^c-sm/hinfx/SWe/KSfil" 
wnlins? Iccsl- "using: t*i^pter_2_ Program 匪 2 ■ 
wrtil^i&i d=- http-i/Zie Ksnai, Mic c-offl/e^pres s iofi/blend/JOeS' 1 

jail http i//s-c hsflas ■ org/iftafkup- c^ipatibii lty/200t ! 

tic i Ignorabl 守 ■■’(!■> 




> 


s 

s 


一 ttcv-c^s -the <Pajc 
ami <^vid> -tags 

that the IDE 

jc^cv-a-tcd -Pov you 
>n\)cy\ you dv-ca-ted 

^ ihc blank app. 

<Grid eackgrrwnd=" {staticReso^iriie AppUcatianPageBackgroundTh^neDrus ti} 11 > 
cQrid. HwDefinition i &> 


□ 



ttcv-c av-c *thc v-ov/ a 灼 d 

dolumy> 於 s: iiiVCC 

vov/s av>d *t>wo dolumv>s. 


白 


B 


日 


B 


«RwOefInition/> 
</Qridl. HoMOefinitiansj 
<Grid XolimnDefir itions> 
^C^lvnnDefi niticin/> 
^•C^lwnnDefi r»ition/> 
</Grid. c&lufliitief initions> 


Outt-on KiNsne-HJKjttDnl 11 Content - r, ShiffN s TOMSge 1 



W\\tv\ you doublc-tlidkcd 

OY\ ea^V> bu*t*fco^, IPS 

^cv>cv*a*tcd a mc*t^od v/rth 

y>arwc o( -the butto 朽 




Norizoftti "Center H c 1 iik= F butt-sn i „cii c k'7 > -follov/cd by Cl'itk. 

^Button jnNsne-"tMjtton2__ Content- M If/e!lsf Hori so*it^ 1^1 i pnrwnt- n C€nter ' 

Grid .Colurin=*i !l c lick= ,! buttQri2_cl ickV> 

^Button k ;Nane ， "bt!ttDW Content -"Another canditi^iai te-st" Hori EontslAl ignnent-"Center" 
Grid._= Ll kfc= 3jlllxk'7 > This button is m 七 he 

scCov\d doluimh dr>d 

^Button K^N^ne-''^ ittonO." Cantenit-"* loop" Horizonte IaI ignment-" Center B , ,, 

SridrCol 酬 -T ^id P Rw-^r ； cLict-™buttofi4_clic k'V > ^ sc ^ so thcsc 


p\rofC\rtics a^rc sci "to / 


<Tej<t&lKi( K?Namg- , 'pyLsl>€r , HDrilontslAl ignnent-"Center M Vertic&1A1 ignuent- "Center " 
Grid , Ro*^"z" 6rid-Oolunfi5pari-"2" 5tyL^ "{stafticHesoupce B 吻 Text style}"" 

"Grid 》 

</P^> 


133 % 





Why do you think the left column and top row are given the 
number 0, not 1? Why is it OK to leave out the Grid. Row 
and Grid. Column properties for the top-left cell? 
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it’s all just code 


Make each button do something 


Here’s how your program is going to work. Each time you press one 
of the buttons, it will update the TextBlock at the bottom (which you 
named myLabel) with a different message. The way you’ll do it is 
by adding code to each of the four event handler methods that you 
had the IDE generate for you. Let’s get started! 


fop 

IPt -follow alo%. 
Well tell you 

do, po'm*b ou*b wha 七 *to look 
-fov- *to yt *bV^C W\OS*t ou*t 
如 wc sV^ow you. 




❶ MAKB BUTT^Nl UPOATB THB UABBU^ 

Go to the code for the buttonl_Click () method and fill in 
the code below. This is your chance to really understand what 
every statement does, and why the program will show this output: 


name is Quentin 
X is 51 

d is 1_5707963267949 


Here’s the code for the button: 


A helpful tips 

* Don’t forget that all your statements 
need to end in a semicolon: 

name = "Joe"; 

* You can add comments to your code 
by starting them with two slashes: 

// this text is ignored 

* Variables are declared with a name 
and a type (there are plenty of types 
that you’ll learn about in Chapter 4): 

int weight; 

// weight is an integer 

* The code for a class or a method goes 
between curly braces: 

public void Go() { 

// your code here 

} 

* Most of the time, extra whitespace is 
fine: 

int j = 1234 ; 

is the same as: 

int j = 1234; 


% IS a vaV»aWc ^ 

tells 

ay, a^a v-cst 

of ^ sets 

vts value *to 

lihe d\rcatcs the output 
pirogirairw ： -the updated 

text ih the Tcx-tBlodk 

myLabel. 


private void buttonl Click(object sender, RoutedEventArgs e) 




Run your program and make 


// this is a comment 
string name = "Quentin 
int (?)= 3; 
x = x * 17; 

double d = Math.PI / 2; 
myLabel.Text = "name is 
+ "\nx is " + x 
+ M \nd is " + d; 

\_ The \h is av\ escape se^uey^e 
"to add a l*mc b\rcak -to the 
TextBlock -text 


PI. /VJaih lives ih 
so ih c 

+'le -this ,od C 


name 


L ^k'ly ； the IDB 

ihc usi h a |j hC 

TOV you. 


sure the output matches the 
screenshot on this page. 




Flip tfce paige t9 finisji your program! 

you are here ► 
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the things you can do 


Setup conditions and see if theyVe true 


Use if/else statements to tell your program to do certain 
things only when the conditions you set up are (or aren’t) true. 

Use logical operators to check conditions 

You’ve just looked at the == operator, which you use to test whether two 
variables are equal. There are a few other operators, too. Don’t worry about 
memorizing them right now~you’ll get to know them over the next few 
chapters. 

* The ! = operator works a lot like ==, except it’s true if the two things 
you’re comparing are not equal. 

★ You can use > and < to compare numbers and see if one is bigger or 
smaller than the other. 


Wken you use 
a conditional 
operator to 
compare two 
numbers ， it’s 
called a 

conditional test. 



❺ 


The ==， ！ =， >,and < operators are called conditional operators. 
When you use them to test two variables or values, it’s called 
performing a conditional test. 

You can combine individual conditional tests into one long test using 
the & & operator for AND and the | | operator for OR. So to check if 
i equals 3 or j is less than 5, do (i == 3) | | (j < 5). 


Make su\rc you s-fcop youv- p\ro^am be^ov-e 
you do this—the (PE let you edit 

SBT A VARIABUB AMt> THSN CHBCK ITS VAUUB^ ^ while the ^oyra^s 

Here’s the code for the second button. It’s an if/else statement Y©u stop it by dlosmg the window； 

that checks an integer variable called x to see if it’s equal to 10. USm 3 stop button oy\ the "toolbav, 

ov* Sxop -rvorw "the 

Debug mehu. 


private void button2_Click(obj ect sender, RoutedEventArgs e) 


Fi^rs-t wc sei 



= 5; 

== 10 ) 


U P cl vaHablc 
called x ahd 

"to Thch wc 

乙 he 乙 k i*p •_ 七 ’s 
-to 10. 


myLabel.Text 

} 

else 


myLabel.Text 
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"x must be 10"; 


"x isn^ t 10"; 



xisnt 10 


Here’s the output. See if you can tweak one line 
of code and get it to say “x must be 10” instead. 





it’s all iust code 

❺ At>t> AN^THBB C^Nt>ITI^NAU T5ST- 

The third button makes this output. Then change it so someValue is set to 3 instead of 4. The TextBlock 
gets updated twice, but it happens so fast that you can’t see it. Put a breakpoint on the first statement and 
step through the method, using Alt-Tab to switch to the app and back to make sure the TextBlock gets 
updated. 


this line runs no matter what 


TVis Ime cMtcVs someValue *to 
see "to ^>) 

i 七 cMtcMs make suv-c 

•,s w vW，. 


private void button3 Click(object sender, RoutedEventArg 


int someValue = 4; 

string name = "Bobbo Jr."; 

if ((someValue —— 3) && (name —— "Joe")) 



myLabel.Text 


'x is 3 and the name is Joe 


myLabel.Text 


'this line runs no matter what' 


❹ At>I> UOOPS TO y^UB 

Here’s the code for the last button. It’s got two loops. The first is a while loop, which 
repeats the statements inside the brackets as long as the condition is true —— do something 
while this is true. The second one is a for loop. Take a look and see how it works. 


private void button4 Click(object sender, RoutedEventArgs e) 


This loop keeps 

v-cpcatihg as Ioh0 as 

the 乙 ouhi Vd\ridble 
is less thah 10. 


TV^IS sets uf loop. 
I 七 just assies a 
value *to *tV^c m 七 cf 
佚 a 七 ’lUc used m 


int count = 0; 

k while (count < 10) 
{ 

count = count 

} 


for «int 



0/ r i < 5; i++) 


count — count — 1 


myLabel.Text 


The answer is 


I ㉗ 在 



is 

is less 

klodk »S 17 心七士 S 


count; 


TV^is yts c%c 巧七 cd a 七 

i\st cv>d loop, k tW»s 6asc, 

•，七 adds emc Vi 叫 W 

|oo ? chutes. TW.S \S called-bje 

•,WaW，d 丨七、 ⑽ ， ，也 a 七 A 
aftev ； alUk statements m the 
todt Wodk. 


Before you click on the button, read through the code and try to figure out what the 
TextBlock will show. Then click the button and see if you were right! 木 


you are 
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over and over and over and... 

- i^^rpen your pencil 


Let’s get a little more practice with conditional tests and loops. Take a 
look at the code below. Circle the conditional tests, and fill in the blanks 
so that the comments correctly describe the code that’s being run. 


you. 


int result = 0; // this variable will hold the final result ^ -Pilled ih the 

A 本 -- -fivst one 

int x = 6; // declare a variable x and set it to «> 

while (x > 3) { 

// execute these statements as long as 


result = result + x; // add x 


x 


x - 1; // subtract 


for (int z 


z < 3; z 


z 


1) 


// start the loop by 


// keep looping as long as 
// after each loop. 


result = result + z; // 


// The next statement will update a TextBlock with text that says 

// 


myLabel.Text 


The result is 


result 


about ^ohdi^tiohd! -tes-fcs 

You dah do simple dohdi-tiohal tests by dhcdkihg -the value a variable us— 
a donr>pa\risoh operator. Wcrts how you Compare -two \v\is, x ahd y ： 

x < y (less than) 
x > y (greater than) 

x == y (equals - and yes, with two equals signs) 

These a\rc i\\c OhCS you II use most 
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it’s all just code 



o O 


VOAIT UPi THSEB，S A FLAW IN Y^UR 
U>&\C. VOHAT HAPPENS JO MY U>OP IF I 
WRITE A ^MDITI^NAU TEST THAT NBVBR 

BBCmBS 


FAUSS?^. 



Then your loop runs forever! 

Every time your program runs a conditional test, the result 
is either true or false. If it’s true, then your program 
goes through the loop one more time. Every loop should 
have code that, if it’s run enough times, should cause 
the conditional test to eventually return false. But if it 
doesn’t, then the loop will keep running until you kill the 


program or turn the computer off! 




matted a， ▲知 气 


c^^rpen your 


pencil 


丁 W 、 s \s 一 e s 加 ^ 




Here are a few loops. Write down if each loop will repeat forever or 
eventually end. If it’s going to end, how many times will it loop? 


LOOP #i 

int count = 5; 
while (count > 0) { 

count = count * 3; 
count = count * -1; 

} f*ov Loop 养孓， hov/ 


LOOP #3 

int j = 2; 
for (int i 


LOOP 

int p — 


< 100 


★ 


2 ) 


轉 5 

2 ; 

for (int q 
q = q 


★ 


2; q < 32; 

2 ) 


mdr\y tiw'CS y/ill 七 iVis 

be C'/'Ctutcd? 



LOOP #2 

int i = 0; 
int count = 
while (i =: 
count 
count 


5; 


while 

{ 

P : 

} 

q = p 


(p < q) 


P 


女 


2 ; 




2 ; 

: 0 ) { 
count ^ 
count * 


3; 

-1 


LOOP #V 

while (true) 


Fov Loop 养今 , how 

times will this } 

be c^^uted? Hih-t ： P stav-ts out io 

2>. 丁 hihk about v/hch the 
{ int i = 1; } ^ itc\ra-toir U p - p ^ Z w is 

executed. 


Rcmcrwbcv-, a -Pov- loop always 
\TUhS the dohdi-tiohcll test at the 
bcjihhihj of ihc \)\oCk, and the 
i"tcv-a*to\r a*t -the o-p the blodk. 





Can you think of a reason that you’d want to write a 
loop that never stops running? 


you are here ► 
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if only，but only if 


Let’s get a little more practice with conditional tests and loops. Take a 
look at the code below. Circle the conditional tests, and fill in the blanks 
so that the comments correctly describe the code that’s being run. 

int result =0; // this variable will hold the final result 

int x = 6; // declare a variable x and sc*t i*t "to 

while { 

// execute these statements as long as 乂 is 3 

result = result + x; // add x *fco 七 1 化 \rcsul"t V3viable 

x = x - 1; // subtract I y3luc y. 

} ^ _ 丁卜 1 s loop 浐 ⑽ s iv/idc—Piirsi v/iih z. sci bo I, 3v\d 

— 七 he 灼 a scdor>d time v/iih z. sci bo z. 0y\6c ii hits 
for (int z = 1; S) z = z + 1) { i 仏⑽ | 咖， I 议七 ha" so the loop siops. 

// start the loop by - ^r. .^.4.."t?..( 

// keep looping as long as 七 h 和"多 

// after each loop, add I. *bo. z ： 

result = result + z; // ddd "the V3luc o-f 2 - *fco \rcsul"t 

} 

// The next statement will update a TextBlock with text that says 

// TKc \rcsuli is 10 

myLabel.Text = "The result is n + result; 


c^^rpen your pencil 


c^terpen your pencil 


Here are a few loops. Write down if each loop will repeat forever or 
eventually end. If it's going to end, how many times will it loop? 


LOOP #i 

This loop executes once 


LOOP #3 

This loop executes 7 times 


LOOP #5 

This loop 
executes 8 times 


LOOP #2 LOOP #V 

This loop runs forever Another infinite loop 

Take the time to v-cally -fijuv-c this oy\C out. ttcrc’s d oppo\rtu^i*ty b> bry out the dcbujyv- OY\ youv ovm. Set a 

breakfomi oy\ i\\t staiem 伙七 二 P 一 V Add wa*Uhcs -for i\\t variables p a^d <\ a^d step *bWou# ihc loop. 
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it’s all just code 


thereiare no 。 

Dumb Questi9ns 


Is every statement always in a class? 

^/\^二 Yes. Any time a C# program does something, it’s because 
statements were executed. Those statements are a part of classes, 
and those classes are a part of namespaces. Even when it looks 
like something is not a statement in a class—like when you use 
the designer to set a property on a control on your page—if you 
search through your code you’ll find that the IDE added or changed 
statements inside a class somewhere. 

Are there any namespaces I’m not allowed to use? Are 
there any I have to use? 

Yes, there are a few namespaces that will technically work, but 
which you should avoid. Notice how all of the using lines at the 
top of your C# class files always said System? That’s because 
there’s a System namespace that’s used by the Windows Store 
API and the .NET Framework. It's where you find all of your important 
tools to add power to your programs, like System. Linq, which 
lets you manipulate sequences of data, and System. 10, which 
lets you work with files and data streams. But for the most part, you 
can choose any name you want for a namespace (as long as it only 
has letters, numbers, and underscores). When you create a new 
program, the IDE will automatically choose a namespace for you based 
on the program’s name. 

I still don’t get why I need this partial class stuff. 

Partial classes are how you can spread the code for one class 
between more than one file. The IDE does that when it creates 
a page—it keeps the code you edit in one file (like MainPage. 
xaml), and the code it modifies automatically for you in another file 
(MainPage.xaml.es). You don’t need to do that with a namespace, 
though. One namespace can span two, three, or a dozen or more 
files. Just put the namespace declaration at the top of the file, and 
everything within the curly brackets after the declaration is inside 
the same namespace. One more thing: you can have more than one 
class in a file. And you can have more than one namespace in a file. 
You’ll learn a lot more about classes in the next few chapters. 

Let’s say I drag something onto my page, so the IDE 
generates a bunch of code automatically. What happens to that 
code if I click Undo? 


The best way to answer this question is to try it! Give it a shot- 
do something where the IDE generates some code for you. 

Drag a button on a page, change properties. Then try to undo it. 

What happens? For most simple things, you’ll see that the IDE is 
smart enough to undo it itself. (For some more complex things, like 
working with databases, you might be given a warning message that 
you’re about to make a change that the IDE can’t undo. You won’t 
see any of those in this book.) 

So exactly how careful do I have to be with the code that’s 
automatically generated by the IDE? 

You should generally be pretty careful. It's really useful to 
know what the IDE is doing to your code, and once in a while you’ll 
need to know what’s in there in order to solve a serious problem. But 
in almost all cases, you'll be able to do everything you need to do 
through the IDE. 

BULLET POINTS - 


■ You tell your program to perform actions using 
statements. Statements are always part of classes, and 
every class is in a namespace. 

■ Every statement ends with a semicolon (；). 

■ When you use the visual tools in the Visual Studio IDE, 
it automatically adds or changes code in your program. 

■ Code blocks are surrounded by curly braces { }. 
Classes, while loops, if/else statements, and lots of 
other kinds of statements use those blocks. 

■ A conditional test is either true or false. You use 
conditional tests to determine when a loop ends, and 
which block of code to execute in an if/else statement. 

■ Any time your program needs to store some data, you 
use a variable. Use = to assign a variable, and == to 
test if two variables are equal. 

■ Awhile loop runs everything within its block (defined 
by curly braces) as long as the conditional test is true. 

■ If the conditional test is false, the while loop code 
block won’t run, and execution will move down to the 
code immediately after the loop block. 


you are here ► 
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your code...now in magnet form 



Code Magnets 

Part of a C# program is all scrambled up on the fridge. Can you rearrange 
the code snippets to make a working C# program that produces the 
output? Some of the curly braces fell on the floor and they were too small 
to pick up, so feel free to add as many of those as you need! (Hint: you’ll 
definitely need to add a couple. Just write them in!) 




Output: 



Tii'is is a 

- Tc%*tBlodk ^ 
U oiA*tpu*t W 

i\\ai *bV\c 

nra 州外 date 

by sc-ttmj i*b 


► Answers on pa^e 86. 
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Wc\\ give you a \oi o( crises like iW\s thv-oughoul the \>ooV~ 
,'； 9 ivc y® u ^ ―赠 m a Couple o( pays. |( you siuk, 

dem 七 be aWa\d h> peek ai the ahswc\r—it s ^hcatmg/ 


it’s all just code 

V^ll be d\rcatmj a lo-t o-P appkalions 
th\roujlioui 七 his book, av\d youll y\ttA bo give 
Cddh ohC 3 di*f-fc\rc^*t IA/lc VCdommcirtcl 
this ov\t w P\radiidcUsmg|-PElsc w . li helps 匕 put 
pv-ojv-arws -Pv-orw a thaptev- m ihc same -foldcv-. 


Time to get some practice using if/else statements. Can you build this program? 


KCi $6 


Build this page. 

It’s got a grid with two 
rows and two columns. 


I-P you ^\rcatc two \rows dhd 
srt 0 此 \rows height io 1^ m 

"the IPB, it seems -fco dis^ppedv* 
because i-t S Collapsed -to a tmy 
Sl2 ^. Just set the othev- v-ow 
"to 1 ^ 3hd itll show up a^aih. 



Add a Button and a CheckBox. 

You can find the CheckBox control in the toolbox, 
just below the Button control. Set the Button’s name 
to changeText and the CheckBox’s name to 
enableCheckbox. Use the Edit Text right-click 
menu option to set the text for both controls (hit 
Escape to finish editing the text). Right-click on each 
control and chose Reset Layout^All, then make 
sure both of them have their VerticalAlignment and 
HorizontalAlignment set to Center. 


Add a TextBlock. 

It’s almost identical to the one you 
added to the bottom of the page in 
the last project. This time, name it 
labelToChange and set its Grid. 
Row property to " 1 . 


Set the TextBlock to this message if the user clicks the button but the box IS 


NOT checked. 

Here’s the conditional test to see if the checkbox is 

enableCheckbox.IsChecked == true 




If that test is NOT true, then your program should execute two statements: 


广 you’ll pu 七七 his 
(Co&t \y\ 七 he else bio 乙 k. 


labelToChange.Text = "Text changing is disabled"; 
labelToChange.HorizontalAlignment = HorizontalAlignment.Center; 


If the user clicks the button and the box IS checked, change the TextBlock so it 
either shows on the lefthand side or ||Jgm on the righthand side. 


If the label’s Text property is currently equal to "Right" then the program should change the text to 
"Left" and set its HorizontalAlignment property to HorizontalAlignment. Left. Otherwise, set 
its text to "Right "and its HorizontalAlignment property to HorizontalAlignment. Right. This 
should cause the program to flip the label back and forth when the user presses the button —— but only if the 
checkbox is checked. 


you are here ► 
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this puzzle’s tougher than it looks 



Paa] Puzz]c 

Your job is to take code snippets from 
the pool and place them into 
the blank lines in the code. You 
may not use the same snippet 
more than once, and you won’t 
need to use all the snippets. 
Your goal is to make a class 
that will compile and run. Don’t 
be fooled — this one’s harder than it 
looks. 


Output 


a noise annoys an oyster 

dy\d we also javc \i 
w ou*tput • 


We mdludcd *thcsc Pool PuzzJc c^cv-discs *th\roujhou*t book 
*to jive you\r b\rdm cx.*tv*3—*toujh y/o\rkout l-r you’ve k'md 


o( person y/ho loves *bwis*ty little lo^id puzzles, 

»•(： do 


you’ll love 

•this oy\c- l-f you Ye y\o{,, yve i*t a sho*t anyway—bu*t do / 七 be 
a-fvaid *bo look a 七 a^sy/cv- b> -figuv-c ou 七 y/haVs jomj o^. 
/W y ouVc stumped by a pool puzzle, dc-f*mi*tcly move oy\- 


Note: each snippet 
from the pool can only 
be used once! 


int x = ◦; 
string poem 

while ( 


if 


x < 


if 


if 


x 


if 



u x>o 







x< 1 

X 

=x + 1; 





f X > 1 

X 

=x + 2; 





x > 3 

X 

=x - 2; 

poem = 

: poem + 

"noys 

poem 

=poem + " x < 4 

X 

=x - 1; 

poem = 

=poem + 

"oise 

poem 

=poem + "a"; 



poem = 

: poem + 

" oyster 

poem 

=poem + "n"; output.Text : 

=poem; 

poem = 

=poem + 

"annoys"; 

poem 

=poem + "an"; 



poem = 

: poem + 

"noise"; 
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it’s all just code 



Time to get some practice using if/else statements. Can you build this program? 

^ added liw b^aks as 
usual "to make it easier 
"t° oh -fchc 

Here’s the XAML code for the grid: 

<Grid Background="{StaticResource ApplicationPageBackgroundThemeBrush} 
<Grid.RowDefinitions> 


内购鉍 
§OLlitlOH 




> 


<RowDefinition/> 

<RowDefinition/> 

</Grid.RowDefinitions> 

<Grid.ColumnDefinitions> 

<ColumnDefinition/> 

<ColumnDefinition/> 

</Grid.ColumnDefinitions> 

<Button x : Name= M changeText n Content: 

HorizontalAlignment="Center' 


^ y° u doMc-d\c.kcd the buWoh ih the des\^ 

bc-rovc you set its i-t may have Seated a 

Ckk event hahdlcv r^cihod called BuOo^ did 10 

instead ok 匕 hahgeTix 七一 Cli 乙 kO. 


Change the label if checked 
Click="changeText Click" / > 



<CheckBox x : Name="enableCheckbox n Content^"Enable label changing" 

HorizontalAlignment="Center" 工 sChecked= n true，' Grid.Column= M 1"/> 


<TextBlock x : Name= n labelToChange" Grid.Row= M 1" TextWrapping="Wrap" 

Text="Press the button to set my text" 

HorizontalAlignment="Center" VerticalAlignment= M Center" 
Grid.ColumnSpan= M 2"/> 

</Grid> 


And here’s the C# code for the button’s event handler method: 

private void changeText_Click(obj ect sender, RoutedEventArgs e) 

{ _ 

if (enableCheckbox • 工 sChecked == true) 

{ 

if (labelToChange.Text == "Right") 

{ 

labelToChange.Text = "Left"; 

labelToChange.HorizontalAlignment = HorizontalAlignment.Left; 

} 

else 

{ 

labelToChange.Text = "Right"; 

labelToChange.HorizontalAlignment = HorizontalAlignment.Right; 

} 

} 

else 


labelToChange.Text = "Text changing is disabled"; 
labelToChange.HorizontalAlignment = HorizontalAlignment.Center; 


you are here ► 
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introducing a different kind of app 



Code Magnets 
Solution 



Puzz]c 



int x = 0; 
string poem ="", 

while ( X < 4 ) { 


poem = poem + "a"; 

if ( x < 1 ) { 

poem = poem + 

} 

poem = poem + "n"; 

if ( X > 1 ) { 

poem = poem + 11 oyster"; 
x = x + 2; 


if (x == 1 ) { 

poem = poem + "noys 11 ; 


if ( X < 1 ) { 

poem = poem + "oise 

} 


x = x + 1; 

} 

output • Text = poem; 


Did you get a different solution? Type it into 
the IDE and see if it works! There’s more than 
one correct solution to the pool puzzle. 


l-f you a v-eal see i-f you out what that othev- solution \sj ttcv-c s a 

86 Chapter 2 h'mt *bhcvVs soluiio^ *tha*b keeps -the word m order, l-f you up y/i*th 

thai solution mstcad o( ihc OY\t oy\ -this page, set i-f you tar\ -fijuv-c ou*b why ihis oy\C v/o\rb "too- 



厂七 did^-t 4|| 
the -rmidge... 


int x = 3; 



TV 七 “ c 七 k。— 七 

loop, x. c<\ual -to i, so *bWis 
wdiWal 七 csU be Wc. 




This s-tatcrwCht 
r^akes x e^ual 
"to Z the -ri\rs-t 
ti^C thvough 

the loop, ahd 

I the scdor\d 
tirwC thvough. 


if (x == 

2) { 


result 

=result + 

n b c n ; 

} 





output.Text = result; 






















it’s all just code 


Windows desktop apps arc easy to build 

Windows 8 brought Windows Store apps, and that gave everyone a totally new way 
to use software on Windows. But that’s not the only kind of program that you can 
create with Visual Studio. You can use Visual Studio for Windows Desktop to build 
Windows Desktop applications that run in windows on your Windows 8 desktop. 


Start 



£ 



Desktop 


a 




Internet Explorer Store 


' *»• 




My D_estt(¥ 


_ a mm 

0 Bw 决 

^ FiashyTlmng 


□ 


Well use Visual Studio 

Jpov W'\y\Ao\ns Pcsk*bop 
*to build pvoyams 七 
yurt m y/mdov/s oy\ you\r 
W\y\do\NS ^ dcsk*bop. 



0 




Windows Desktop apps are an effective learning tool 

We’ll spend the next several chapters building programs using Visual Studio 
for Windows Desktop before coming back to Windows Store apps. The 
reason is that in many ways, Windows Desktop apps are simpler. They may 
not look as slick, and more importantly, they don’t integrate with Windows 
8 or provide the great, consistent user interface that you get with Windows 
Store apps. But there are a lot of important, fundamental concepts that 
you need to understand in order to build Windows Store apps effectively. 
Windows Desktop programming is a great tool for exploring those 
fundamental concepts. We’ll return to programming Windows Store 
apps once we’ve laid down that foundation. 


yrtai v-casoh -to 
lea\rh l/Vihdows Pcsk-fcop 
pvoya 咖 mg is that you 
get -to see -the same thmg 
done mo\rc thah ohe way. 
That s a \rcally 'uidk way 
■to get doh^pts ih-to you\r 
bam. Flip the page io 
see what wc meah... 
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this looks oddly familiar 


Rebuild your app for Windows Pesktop 

Start up Visual Studio 2012 for Windows Desktop and create a new project. This 
time, you’ll see different options than before. Click on Visual C# and Windows, 

and create a new Windows Forms Application project. 




Kov-mally you 
should t\)OOSt 

a bc*t*tcv Mmc 
*bha^ w Chap*tcv- 
Z - Pvoyam 

七 ’’ but v/cVc 
specifically us'mg 
a Y\Bn\t with 


spaces a 
hyphen -fov *thi 
p\rojcd*b so you 
tBY\ set what 
it docs *to *thc 


s 



\fJlHt>OVJS F^iaMS APPS START MTU A F^M THAT YOU CAN ^BSIZB^ 


>BM TH 

at you d( 


Your Windows Forms Application has a main window that you design using the designer in the IDE. 
Start by resizing it to 500 x 130. Find the handle on the form in the Designer window and drag to resize 
it. As you drag it, keep an eye on the changing numbers in the status bar in the IDE that show you the 


new size. Keep dragging until you see 


xm 


in the status bar. 





Keep dv-aggmj -these handles 
u>vtil you\r -fo\rrw is -the vigh 七 sizjC. 


qQ 


Forml 


Hcvc s y/Via*t Y ouV " 

-(■ov*w\ should look 
like a*f*tcv- you 
resize i*t* 

.y.................. 

r^n 同 m 
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it’s all just code 


Change the label if checked 



CheckBox 
CheckedListBox 
ColorDialog 
ComboBoK 
ContextMenuStrip 
DataGridVie^ 
DataSet 

DateTimePicker 
Directory Entry 
Di recto rySearc her 
DomainUpDown 
ErrorProvider 
EventLog 

Fil eSystem Watcher 
口丨 owLayoutPanel 
Fold erB rowserD i a I o g 
FontDialog 
GroupBoK 
HelpProvider 


司 [回涵 


On the next page you’ll use the Properties window 
to change the text on each control, and to set the 
CheckBox control’s state to checked. See if you can 
figure out how to do that before you flip the page! 


0 函 


E Enable label changing 


The IDE helps you ali^ youv- do>rbrols by displaying 
Irncs as you d\raj -them the -fovm. 


□□ 


My Desktop App 


回 觀 


□ID 

A 

A 


HScrollBar 
Imagelist 
Label 
LinkLabel 


Change the label if checked 


Enable labd changing 


▼ 


Press the button to change my text 


Hint: you’ll need to use the AutoSize property 
to get the Label control to look right. 
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⑩ 


o 


THB TITUB ^>F Y^UB 

Right now the form has the default title (“Forml”). You can 
change that by clicking on the form to select it, and then 
changing the Text property in the Properties window. 


Forml System.Windows.Forms.Form 


^ f 


RightToLeft No 
Ri ghtTo Left Lay o False 

My Desktop App 
UseWaitCursor False 
Text 

The text assod 


▲ 


My Desktop App 



At>t> A BUTTON, CUBCKBOX, ANt> LAB 5 L- 

Open up the toolbox and drag a Button, CheckBox, and 
Label control onto your form. 



Make sure you’re 
using the right 
t v Visual Studio 

Watch it! /f ,. 

If you re using the 
Express edition of Visual Studio 
2012, you’ll need to install two 
versions. You } ve been using Visual 
Studio 2012 for Windows 8 to build 
Windows Store apps. Now you’ll 
need to use Visual Studio 2012 
for Windows Desktop. Luckily, 
both Express editions are available 
for free from Microsoft 


Search Tool b ok 
J All Windows Forms 
kt Pointer 

P BackgroundWorker 
BindingNavigator 
iyj BindingSource 


P 


▲ 


Q 

O 

X 


You can expand the toolbox by choosing “Toolbox” from 
the View menu, or by clicking on the Toolbox tab on the 
side of the IDE. You can keep it from disappearing by 
clicking the pushpin icon (H) on the Toolbox window. You 
can also drag the window title so that it floats over the IDE. 

These spadev Imcs help you position youv- ^o^-tv-ols as you dird^ -them avouhd. 


Button 


Too box 


Toolbox 


Properties 


omSE ^ 琶 lo^ ei 'l E p□ o El ElriG 国 O B 










































































deja vu 

O USB THB PR0P5RTI5S WllbJ^WI T^> SBT UP THB CObimOUS^ 

Click on the Button control to select it. Then go to the Properties window and set its Text property: 

Change the label: If checked 

Change the Text property for the CheckBox control and the Label control so they match the screenshot on 
the next page, and set the CheckBox’s Checked property to True. Then select the Label control and set the 

TextAlign control to Middle Center. Use the Properties window to 
set the names of your controls. Name the Button change Text, 
set the CheckBox control’s name to enableCheckbox, and 
name the Label control labelToChange. Look at the code below 
carefully and see if you can see how those names are used in the code. 

Change the AutoSize property on the Label control to False. 
Labels normally resize themselves based on their contents. Disabling 
AutoSize to true causes the drag handles to show up. Drag it so 
it’s the entire width of the window. 





AV>V> THB eVe^JT HANr>LBe F 從 Y^>UB BUTTON. 

Double-click on the button to make the IDE add an event handler method. Here’s the code: 


Cha pta_Z_ Phog ram_4.Fci mil 

Fnam^spac^ Chapter_2_Pr l ogra*_4 


© Fermi fl 


十 


曰 

- 


E3 


121 % - 


P ublic pertJal clas5 For ^ : For ^ you AoMt-cWcktA -the 
public Form 1() i\\t IPS 七 ed 七 iVi 


s 


cvcv>*t hair>dlcv- a^d earned i*t 

Initiaiizecofrtponent [ b> youv 

《 bu*t*to^s 

private void changeT t_C1 ickC object EvertArgs @) 


} 


■ - (erableCheckbox.Checked == true) 


i 『 {la be IToCha nge T 


Right. 1 } 


labelToChange.I&xt - "Left"; 

la be IToCha nge ■ T extAl ign = Cnlent Alig nrnent. Midd leLeftj 


else 


labelToChange - Text = "Right" i 

la be I T oC hangs, TextAlign — tonten 丄 .ignrier .l » Middle Right: 


} 


else 


labelToCharge^Text = "Text changing is disabled"; 
labelToChange ■ TextAlign — Conterizfll Igrinent . Hid d leC ente r 






Wcvcs the Code 
fo\r the CVCht 
K^hdlcv- method, 
"fake a dav-c-Pul 

look — cby\ you sec 

diHcvcht 
*(Vorw the similar 


^ode vou added 
excise? 


coat you 

-Po\r the ( 
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it’s all just code 


□ ^ 


My Desktop App 


n 


Change the label if checked 


Enable label changing 


Press the button to diange my text 


Debug your program in the IDE. 

When you do, the IDE will build your 
program and run it, which pops up the 
main window that you built. Try clicking 
the button and checkbox. 


□□ 


My Desktop App 


n 


Change the label if checked 


Enable label changing 


Right 


W\\tY\ label is 

enabled, the label shows 
cithcv Lc-P*t or Rijht 

l-f its disabled, rt shows 
a message 


c^^rpen your pencil 




My Desktop App 


n 


Change the label if checked 


Enable label changing 


Clidk 七 lie 
dhcdkbo% *to 
enable or 
disable label 


Left <- 


□□ 


My Desktop App 


Change the label if checked 


V 

Text changing is disabled 



Fill in the annotations so they describe the lines in this C# file 
that they’re pointing to. We’ve filled in the first one for you. Can 
you guess what the last annotation should say? 


using System; 
using System.Linq; 
using System.Text; 
using System. Windows . Forms 



C 非 classes 

l^s；^ 

. 


namespace SomeNamespace 



class MyClass { 




public static void DoSomething() { 


MessageBox.Show("This is a message"); 


Here’s a hint. You haven’t seen MessageBox yet, but 
it’s something that a lot of desktop apps use. Like 
most classes and methods, it has a sensible name. 



Solution on pqge 95 
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a closer look 

Your desktop app knows 
where to start 

When you created the new Windows Forms 
Application project, one of the files the IDE added 
was called Program.es. Go to the Solution Explorer and 
double-click on it. It’s got a class called Program, and 
inside that class is a method called Main () . That 
method is the entry point, which means that it’s the 
very first thing that’s run in your program. 


Desktop apps are different, 
and that’s good for learning. 

Windows Desktop applications 
are a lot less slick than Windows 
Store apps because it’s much harder (but not 
impossible) to build the kinds of advanced user 
interfaces that Windows Store apps give you. And 
that’s a good thing for now! Beacuse they’re simple 
and straightforward, desktop apps are a great 
tool for learning the core C# concepts, and that 
will make it much easier for you to understand 
Windows Store apps when we return to them later. 



Heme’s some Code ihc IDE built -fov- you 
au^tomatidally m 七 he las 七 thaptev-. You’ll 
•fmd m Pv-ojv-arw.ds. 



y^ur Tip Ckse 



using System; 
using System.Collections.Generic; 
using System.Linq; 
using System.Threading.Tasks; 
using System.Windows.Forms o 


|PE ylaW U u, ^ 

士 口以二 


namespace4hapter 一 2_Program—4 


static 

{ 


cla 營 


Program 


/ 七 "two o\r rnov*c sldslics 

you sdd a^ywhc\rc you 
The slashes -tell -fco ig^ov-c therw. 


Ill <summary> 

III The main entry point for the application. 

Ill </summary> Ev C vy 

[STAThread] ❺ 
static void Main() 


cry time you \ruh youv 
1 七 heire, ai the chtvy p olh 七 . 


Application.EnableVisualStyles(); 

o Application.SetCompatibleTextRenderingDefault(false) 

Application.Run (new Forml ()) ; ^ ( 1S drcaics 

displays -the artd er\ds -the 

} pv-ojv-am y/hc^ the -Pov-m^s dosed. 


I do dtt\^ 

♦ 

Thc 七 P 价 t J cvev^y dass OV^ 

method is called a ded 的 £ ioh . 
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Rcrwcmbcv-, -this is 
dig iKrfeo ihc Code 
khow what youVc looking at 


jus*t a s 七 avtmj pom 七 -fov you -fco 
.Bu*t bc-fovc you do, you’ll need "to 



















it’s all just code 


These are some of the “nuts and bolts” of desktop apps. You’ll play with them on the next few pages 
so you can see what’s going on behind the scenes. But most of the work you do on desktop apps will 
be done by dragging controls out of the toolbox and onto a form —— and, obviously, editing C# code. 


cn AM> -N5T HAVB UOTS OF BUILT-IN FBATUiaBS^ 

You’ll find lines like this at the top of almost every C# class file. 
System. Windows . Forms is a namespace. The using 
System. Windows . Forms line makes everything in that ^ — . 

namespace available to your program. In this case, that namespace 
has lots of visual elements in it, like buttons and forms. 


Yo U v y/'ill use mov-c a^d w'ov-c 

Mmesfades like *tWis one as you 

about C# NtT's built—m 
-fc3*tuv"cs -t^V"ou^ou*t *tV)C kook- 

you \s\^ Imc, 

youd V^avc bo out System. 

lA/mdoy/s.pov-ms cvcv-y time you use 


THB It>5 C»OSB A MAMBSPACB YOUR COt>B 

Here’s the namespace the IDE created for you —— it chose a 
namespace based on your project’s name. All of the code in your 

program lives in this namespace. let you use the same 

ih pvogira^s, as loh 9 as those 

y^ue C6>t>e IS ST^Bt> IM a CUASS^ P'rogirams arch i also .h ihc same 

This particular class is called Program. The IDE created it 

and added the code that starts the program and brings up the »i. » 

form called Form 1. Y olA ^ 


THIS HAS 0N5 AMO IT 

CONTAINS SBVBjaAU STAT5M5NTS- 

A namespace has classes in it, and classes have methods. 
Inside each method is a set of statements. In this 
program, the statements handle starting up the form. 
You already know that methods are where the action 
happens —— every method does something. 


BACH t>BSKT^P APP HAS A SPBCIAU KIMO 
OF CAUUBt> THB BNmYP^INT^ 

Every desktop app must have exactly one method 
called Main. Even though your program has a lot 
of methods, only one can be the first one that gets 
executed, and that’s your Main method. C# checks 
every class in your code for a method that reads 
static void Main () . Then, when the program 
is run, the first statement in this method gets executed, 
and everything else follows from that first statement. 



Masses a ^amcs ? ate. 

Tc6W»6allv，a ^::。二 

如一 W) 十， v - 6a ； 

tell C# V/W.6V. OV.C »S ttc Urj ? 训七 ... 
wt ， “ 七 ^ ^ do 

Every desktop app must 
kave exactly one metkoct 
called Main. Tkat itietkod 
is tke entry point lor 
your code. 

Wken you run your code ， 
tke code in your MainO 

itietkod is executect FIRST. 
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classy things 


You caw change your 
program's ewtry point 

As long as your program has an entry point, it doesn’t matter 
which class your entry point method is in, or what that method 
does. There’s nothing magical or mysterious about how it works, 
or how your desktop app runs. You can prove it to yourself by 
changing your program’s entry point. 



o 

o 



Go back to the program you just wrote. Edit Program.es and change the 
name of the Main () method to NotMain () . Now try to build and 
run your program. What happens? Can you guess why it happened? 


Rijht-dlidk OY\ the 

pv-ojedt \v\ Piropcirtics 
and select w Add w ar>d 


"Class..." 

Now let’s create a new entry point. Add a new class called AnotherClass. cs. You add a 
class to your program by right-clicking on the project name in the Solution Explorer and 
selecting “Add—Class. • Name your class file AnotherClass.cs. The IDE will add a class to 
your program called AnotherClass. Here’s the file the IDE added: 



using 

using 

using 

using 

using 


System; 

System.Collections.Generic; 
System.Linq; 

System.Text; 

System.Threading.Tasks; 


^ / - TV^csc -fouv sta^davd usmj I'mcs 

added *to -f ile- 

Tiiis tlass is m same 


namespace Chapter_2 


Program_4 4^ — - - 一 added you 

dveated i\\t pvojctt. 


class AnotherClass 




Add a new using line to the top of the file: using System. Windows . Forms; 
Don’t forget to end the line with a semicolon! 


Add this method to the AnotherClass class by typing it in between the curly brackets: 


/l/l^ss^QjeBo% is d C-l3ss 七 1 ^七 
•m System.V\/'mdoy/s.Fov-ms 

is y/V^Y you \\Bd 

{p add us'mj I'mc m step .了 

s 一 Q is a method tv^ats farb 
{\\t McssajcBo% tlass. 


class AnotherClass 

{ 

public static void Main() 

{ 

MessageBox.Show("Pow!" 

} 


C# is case-sensitive! Make sure your upper- and lowercase letters match the example code 
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+ 餐 

run It! 





it’s all fust code 

Desktop apps use MessageBox.Show() to 
pop up windows with messages and alerts. 


So what happened? 

Instead of popping up the app you wrote, your program 
now shows this message box. When you made the new 
Main () method, you gave your program a new entry 
point. Now the first thing the program does is run the 
statements in that method — which means running that 
MessageBox . Show () statement. There’s nothing else 
in that method, so once you click the OK button, the 
program runs out of statements to execute and then it ends. 



Figure out how to fix your program so it pops up the app again. 



tt'mt you or\^ V^avc 

{jo Aa 呼七 …。’ 
七 Y/o -f iles {p do it 


cf^rpen your pencil 

§pL|itlOH 


Fill in the annotations so they describe the lines in this C# file 
that they’re pointing to. We’ve filled in the first one for you. 


using System; 

using System.Linq; 

using System.Text; 

using System. Windows . Forms 



c# Masses 

Ws ^0 add WW 


namespace SomeNamespace 



AH o-P "the CoAt lives ih 
classes, so -the p\TO0V-arw 
^ccds a t\ass hcv-c- 


class MyClass 




public static void DoSomething() { 


TKis dldss lids or\t mc*tKod- 
|*ts is w po£owtiVm 少 
dr^d iVs tailed i*t fofs 
^ 一 up a Mcssa^cBo%. 


MessageBox.Show("This is a message"); 



XW»s »s a s*taWe 灼 t 

•rt ? 0 ? s u ? 3 VrbUe 

Wmdio>w …办 a 

ms\dc ok »"t* 


vessay 
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let’s dig in 


Whew you change things iw the IPE, 
yo uVg also changing your code 


The IDE is great at writing visual code for you. But don’t 
take our word for it. Open up Visual Studio, create a new 
Windows Forms Application project, and see for yourself. 



fills! 


O 0PBN UP THB t>BSI^bJBR 

Open the Form 1 .Designer.es file in the IDE. But this time, instead of opening it in the 
Form Designer, open up its code by right-clicking on it in the Solution Explorer and 
selecting View Code. Look for the Forml class declaration: 

Notice how its a pav-tial dlass? Well talk about that m a m'muie- 

partial class Forml 


❺ apetj up thb t>esi^MeR AtJt> At>t> a picturbb^x t^> y^ue 

Get used to working with more than one tab. Go to the Solution Explorer and open up the Form designer 
by double-clicking on Forml.cs. Drag a new PictureBox control out of the toolbox and onto the form. A 
PictureBox control displays a picture, which you can import from an image file. 

Select “Lodal \rcsou\rdc w a^d 


Choose Image, 


V^>u 灼 Choose the irwajc (or the PidtuircBo^ by sclcdtmj 

i*t -the w Ciioosc Imk m "the Pvopcv-tics 

v/mdow -to pop up a window ihai lets you select the 
load. Choose irwajc -file oy\ youir dorwpu-tcv-/ 


乙 li 匕 k "the (rwpovt... button 

^ "to pop up d didlo^ -fco -f md 
Local resource: 仏 e ^ile {o ir, P ov-t 



❹ 


FIMl> AHt> BXPANt> THB t>BSI^NBia^BbJBiaATBt> COt>B THB PICTilRSBOX- 

Then go back to the Form 1 .Designer.es tab in the IDE. Scroll down and look for this line in the code: 

Clidk oy\ the flus si ， 




lindows Form Designer generated code 


// 


Click on the + on the lefthand side of the line to expand the code. Scroll down and find these lines: 

vou double - 6kk 咖 rn Solution youll tKat you 

\^oritd. TV.C m • 十士 d 扣 d earned ’ 七 >'^^ 。 %1.1^^ - af 七二 

code i^ai *rt 3 ㈣ a 七 ed load 栎 a 七 imay 如 ?\cUSo% toM so rts displayed. 


// pictureBoxl 

// 

this.pictureBoxl. 工 mage 



((System.Drawing. 工 mage)(resources.GetObject("pictureBoxl. 工 mage"))); 


this.pictureBoxl.Location = new System•Drawing•Point(416, 160) 
this.pictureBoxl.Name = "pictureBoxl"; 

this.pictureBoxl.Size = new System.Drawing.Size(141, 147); 
this•pictureBoxl.Tablndex = 0; 
this.pictureBoxl.TabStop = false; 



Po〆 七 v/o\r\rY *tV^C turnkeys 

V ouv Codt U Lodatjov. 

Imcs avc a little 

七 ‘ ttese TV.CY II vav Y dtYt^ 

0 y> v/V^cvc you dva^cd 70UV 
P ' idWcBox . coy\{xoI 
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it’s all just code 


Wait, wait! What did that say? 


Scroll back up for a minute. There it is, at the top of the Windows 
Form Designe 广 generated code section: 



III <summary 〉 

III Required method for Designer support - do not modify 
III the contents of this method with the code editor. 


Ill </ summary> 


There’s nothing more attractive to a kid than a big sign that says, “Don’t touch 
this!” Come on, you know you’re tempted.. .let’s go modify the contents of that 
method with the code editor! Add a button to your form called button 1 
(you’ll need to switch back to the designer), and then go ahead and do this: 


/l/los 七 domrwCir>*ts or>ly s*t3V*t 
y/’rth two slashes (/ /)• 

*tKc iPt sometimes 
adds -these ihvcc-slasK 


These av-C )<A1L 



③ 

❺ 


❺ 

o 


CHAN^B THB COl>B THAT SBTS TUB &UTT0N1.T6XT 
PB^PBBTY^ \^HATt>£> Y£>U THINK IT VJIUU TO THB 
P^PB^TIBS WIINt>^WI IN THB It>e? 

Give it a shot — see what happens! Now go back to the form designer and 
check the Text property. Did it change? 

STAY IN THB ANt> USB THB P 故 P5I2TIBS 

TO CHAN^B THB NAM6 PR^PBRTY T^> 

See if you can find a way to get the IDE to change the Name property. It’s in 
the Properties window at the very top, under “(Name)”. What happened to 
the code? What about the comment in the code? 

CHANTS THB THAT SBTS THB LOCATION 

PR^PBRTY (0,0) AMO THB SIZB P^PB^TY MAKB 

THB BUTTON RBAUUY Bl^ 

Did it work? 

BACK T^> THB t>5SI 彡 N5R, ANO CHAhJ^B TUB BUTTES 
BACKCOLOI^ PSaPeRTY T^> S^MBTHIN^ BUSB^ 

Look closely at the For ml. Designer, cs code. Were any lines added? 


*tKis book *to lcav*v> 

move abou*t 


如 Aoy^i V^avc \x> save 

^ see Just 

w akc m todt 

tab labeled 

Cpcs»^3" -to ^ ^ thc 




It’s always easier to use the IDE to change your form’s designer-generated 
code. But when you do, any change you make in the IDE ends up as a change 
to your project’s code. 



- Dumb Questions 

I don’t quite get what the entry point is. Can you 
explain it one more time? 

Your program has a whole lot of statements in it, but 
they’re not all run at once. The program starts with the first 
statement in the program, executes it, and then goes on to the 


next one, and the next one, etc. Those statements are usually 
organized into a bunch of classes. So when you run your 
program, how does it know which statement to start with? 

That’s where the entry point comes in. The compiler will not build 
your code unless there is exactly one method called Main (), 
which we call the entry point. The program starts running with the 
first statement in Main (). 
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ooh, pretty! 





Desktop apps aren’t nearly as easy to animate as Windows Store apps , 〆 
but it’s definitely possible! Let’s build something flashy to prove it. 

Start by creating a new Windows Forms Application. 


O "採 THB F^>RM 
TO BUIU>. 


Application . DoEvents () ; ^-v 

oth 饮 T\ l Tu ;_。吻 ahd d 。"the 

do^i itself bcLsJ l' i d W ^ ㈣㈣ 几 d 

— s XuXZt " ,h T h, ihe is 

Fov y\oyj, you II use Affl^^-tio^ PoEvc^-bO -to make suv-c 
youv -fov-m stays \rcspoi^sivc while its m a I oof, bu*t its 
kmd of a hadk- Y 0[a shouldn’t use -this code ou*bide o*f a 

■toy pvoyam like -this. Latcv- oy\ m -the book, you II Icav-^ 
about a mudh better way *to let youv fv-oyams do mov-c 
*tha^ oy\c a*t a 七 》^! 

❺ MAKS IT SLMUBe- 

Slow down the flashing by adding this line after the 
Application . DoEvents () line: 

System.Threading.Thread.Sleep(3); 


Lt 知 ㈣ rS ㈡ 。 r: 

bo 七 Wsc 从 c variable, You! c> cv* vayr \ a felc t is al^ady 

❽ MAKB THB BACK^^UbJt> &0 ALL 

PSYCHBt>BUC! 

When the button’s clicked, make the form’s background 
color cycle through a whole lot of colors! Create a loop that 
has a variable c go from 0 to 253. Here’s the block of code 
that goes inside the curly brackets: 

this.BackColor = Color•FromArgb(c, 255 - c, c); 




FlashyThing 


g [ 回 E 


r 


□ ■…… 


Go! 





□ 


Make -the bu-t-fco^ biggev- 
by dlidkmj oy\ a dov-^cv* 
handle and it 


丁 w. 你丁卜 〆:。' 咖如 av>d 






vaWt) 


TW , 如 W 
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it’s all just code 


Rcrwcrwbcv-, io t\rcaic a l/Vi^dows Fov-ms 

- Application you v\tcd bo be us'mj \/isual 

S-tudio -fov 1/Vi^dows Desk-top. 

O it sm^thb^ 

Let’s make the colors cycle back to where they started. Add another loop that has 
c go from 254 down to 0. Use the same block of code inside the curly brackets. 


o Keep it 叭 ⑶ 0hC — IS 

Surround your two loops with another loop that continuously executes and doesn’t ihside 

stop, so that when the button is pressed, the background starts changing colors and ohc, we 乙 all it a 

then keeps doing it. (Hint: the while (true) loop will run forever!) loop. 


Uh oh! The program doesn't stop! 

Run your program in the IDE. Start it looping. Now close the window. Wait a 
minute —— the IDE didn’t go back into edit mode! It’s acting like the program 
is still running. You need to actually stop the program using the square stop 
button in the IDE (or select Stop Debugging from the Debug menu). 


O it stop^ 

Make the loop you added in step #5 stop when the program is 
closed. Change your outer loop to this: 



while (Visible) 

ow run the program and click the X box in the corner. The 
window closes, and then the program stops! Except.. .there’s a 
delay of a few seconds before the IDE goes back to edit mode. 

I/Vheh youVc dhcdkmj a Boolean value like Visible 
•m 扣 ilf sta 七加⑼七 ov a | 00 p, sometimes it's 
tcrwptiha -to test -fov* Risible —— tv-uc). You tdiY\ 
o-fr the — — "tv*uc 一 its Chough "fco ihdludc 

the Boold 


l/Vhch youVc wov-kih^wLh a 

ov* 匕 ok^voI, \/isiblc is 
as lo^g as the -fov-m OV 
is bema displayed- 1( 
you sci it -to -false, it makes 
the -fo\rm o\r ^oh-t\rol disdppeav*. 


《 fv 二 ㉗ 卿. 

^ 11 ^ hahdy {o solve this 

P 浐 oblerh. 


Can you figure out what’s causing that 
delay? Can you fix it so the program ends 
immediately when you close the window? 
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exercise solution 



oOipi\OH 

Some-times we YJOY\i show you the c^iiv-c Code 
•m the solution, \ust the bits thai AH 

J the lojid \v\ the Flashy Tiling pv-ojed-t is *m this 

butUJ 一 CkkO method that the IPB added when 


-the IDE added -this method, i*t added c%tv-a 
vc*tuvr> bc-povc {\\C duvly bvadket Sometimes v/C II fu 七 *thc 
bv*adkc*t *thc same Ime like *this *to save spade 一 bu*t C 养 
docs^^-t care aboui t%{xa spade, so -this is fcv-Pcd-tly valid- 


CoY\s\sitY\t^f is jc^cv-ally v-cally imforba 的七 *to make i-t easy 
(or fcofIc bo read Code- Bu*t v/eVe fu\rposc-Pully showir^ you 
diWcv-cr>*t ways, because you’ll Y\ttd *to used *to v-cadm^ 
dodc -Pv-orn d\((crcr\i fcoflc us'm^ differ ⑶七 styles. 


you double-di 匕 ked the but-fcoh *m the -fov-m desi^er. 

\ 

private void buttonl_Click(object sender, EventArgs e 

/〆—’while (Visible) { 

The outev- loop 

keeps v-uhh'ma as for (int c = 0 ; c < 254 && Visible; C++) 

lohg Ss the TO\rrw 
is visible. As sooh 
as it’s dosed, 

Visible is -false, 
the while 

will s-top loofih^. 

We used && 1 

Visible ms-tcad - for (int c 
ok && Visible 



=Color.FromArgb(c 
Application.DoEvents(); 

System.Threading.Thread.Sleep(3); 


255 - c, c) 


^ y hc -Pivs-t 4<r loop r^akes the 

SC^Ohd ^ loop ircvc^cs -thcr, 
^ So 七 look sr^oo-th. 


254; c >= ◦ && Visible; c--) 


二二 *tv-UC. Its 
\ust like saymj 
i-p it’s visit IC W 
ms*tcad o( W i-P 

rt’s *brue that 
its visible^—they 

mca 灼 the same 


=Color.FromArgb(c 
Application.DoEvents(); 

System.Threading.Thread.Sleep(3); 


255 - c r c) 


lAfe -f ix-cdi *b^c delay by 

usmo, i\st && make 

tacM U loo ? s also c\sttk 

V\s\felc. That 叫七 U 巧 ? ⑶ ds 

m < 一； ^ \AsiWc W ⑽ lalsc. 


Can you figure out what’s causing that as so — as SSI 
delay? Can you fix it so the program ends 
immediately when you close the window? 

The delay happens because the for loops need to finish before the 
while loop can check if Visible is still true. You can fix it by 
adding && Visible to the conditional test in each for loop. 


Was your code a little ctillerent tkan ours? Tltere’s more tkan one way to 
solve any programming problem (e.g., you coulct kave used wkile loops instead 
ol lor loops). II your program works, tken you got tke exercise rigkt! 
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3 objects ： get oriented! 


Making code make sense 


… AMD THAT X S 
WHY MY I4USBANJD 
6UASS DOeSI^T HAVE A 

HeupOuTA 故 uNt>Tb4ekk>useQ 

METHOD OR A 
PuuuHis^^N^Jei^TO 
METHOD. 




Every program you write solves a problem. 

When you’re building a program, it’s always a good idea to start by thinking about what 
problem your program's supposed to solve. That’s why objects are really useful. They 
let you structure your code based on the problem it’s solving, so that you can spend your 
time thinking about the problem you need to work on rather than getting bogged down in 
the mechanics of writing code. When you use objects right, you end up with code that’s 
intuitive to write, and easy to read and change. 


this is a new chapter 
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mike’s going places 


How Mike thinks about his problems 

Mike’s a programmer about to head out to a job 
interview. He can’t wait to show off his G# skills, but 
first he has to get there — and he’s running late! 


o Mike figures out the route hell take to get to the interview. 



o 



Hu TAICB TN5 
31ST STRBBT HEAD 

UP UIBBRTY aVBNUB, AMD &0 
THR^U^N BU^MF I BUD. 



seis his dcs-tiha-tioh, 

七 heh Hornes up with 3 v-ou*tc. 


❺ Good thing he had his radio on. There’s 
a huge traffic jam that'll make him late! 






THIS IS FRANK ： LOUDLY 
WITH y<9UR BYB-IN-THB-SKy SHADOW 
TRAFFIC RBP^RT. IT L^^ICS UKB A 
THRBB-6AR PIUBUP ^)M UIBBRTY HAS 
TRAFFIC BA6KBD UP AUU THB WAYT^ 
32MD STRBBT. 


V 


^ Mike comes up with a new route to get 
to his interview on time. 


h/ovj he C3v\ up 
v/ith a hew \routc "to 
the ih-tevview. 


NO PR^BUBM. IF 
X TAKB FOISTS ZS 
INSTEAD ； HU 
STIUU BB OK TIMBi 


O 


0 
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objects: get oriented! 


How Mike's car Havigation system thinks about his problems 

Mike built his own GPS navigation system, which he d diagram 3 dlass 

uses to help him get around town. m Mike s pv-oyam. I*t sho^s 

七 oy\ 3y\d *bV>C 

methods oy^ bottom. 


SetDestination("Fifth Ave & Penn Ave"); 

string route; s output i\\t 

^ctRoutcO me 栋 od - 1 七、 
a s-bvm^ *b^a*t wtams ^ 
d\rctho^s Mike should Wlo 



route = GetRoute(); 


Navigator 


SetCurrentLocation() 

SetDestination() 

ModifyRouteToAvoid() 

ModifyRouteTolnclude() 

GetRoute() 

GetTimeToDestination() 

TotalDistance() 


J 


Tiic y>av'i^a*k'io^ sys*tcm sc*ts 
a dcs*tma*t»ov> av>d tomes up 
y/i*tK d V"ou*tc- 



Take 31st Street Bridge to Liberty Avenue to Bloomfield 


丁 he K>aviga*tioh system gets 

hew ih-Po\rma-tioh aboui a 

s*t\rcct it heeds -fco avoid. 




ModifyRouteToAvoid("Liberty Ave n ); 






string route; 
route = GetRoute(); 


"Take Route 28 to the Highland Park Bridge to Washington Blvd' 

J 

^ctRoutcO gives a hew v-outc 
"that doesh t ihdludc the 
/Wikc wah-b -to avoid. 

Mike’s navigation system solves tke street 
navigation protlem tke same way ke does. 
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set methods and modify routes 


Mike's Navigator class has methods to set and modify routes 


Mike’s Navigator class has methods, which are where the action happens. But unlike the 
button—Click () methods in the forms you’ve built, they’re all focused around a single 
problem: navigating a route through a city. That’s why Mike stuck them together into one 
class, and called that class Navigator. 

Mike designed his Navigator class so that it’s easy to create and modify routes. To get a 
route, Mike’s program calls the SetDestination () method to set the destination, and 
then uses the GetRoute () method to put the route into a string. If he needs to change the 
route, his program calls the Modif yRouteToAvoid () method to change the route so that 
it avoids a certain street, and then calls the GetRoute () method to get the new directions. 


class Navigator { 



Mike c\\ost method 

would make 

sc^sc *to someone 
y,ds akou-t \\o^i 

•to r\av'»^a-tc a v-ou-tc 


public void SetCurrentLocation(string locationName) { 

public void SetDestination(string destinationName) { 

public void ModifyRouteToAvoid(string streetName) {. 
piiblic (string) GetRoute () { ... } 


—• doeWt it，S ^ 


string route = 

GetRoute() 


Some methods have a return value 

Every method is made up of statements that do things. Some methods just execute 
their statements and then exit. But other methods have a return value, or a value 
that’s calculated or generated inside the method, and sent back to the statement that 
called that method. The type of the return value (like string or int) is called the 

return type. 

The return statement tells the method to immediately exit. If your method doesn’t 
have a return value — which means it’s declared with a return type of void — then 
the return statement doesn’t need any values or variables (“return; ’’)， and you 
don’t always have to have one in your method. But if the method has a return type, 
then it must use the return statement. 

public int MultiplyTwoNumbers(int firstNumber, int secondNumber) 
int result = firstNumber * secondNumber; 

return result; — - TK«s passes -tKc value batk 

} ^ 如 w 糾 •咖 加 % a t 

Here’s a statement that calls a method to multiply two numbers. It returns an int: i A 〜 zUo use to 

弓 .But ⑽。 

? ass values -to a 



七 has a 

vc W an mt TKc mc-tKod uses 

七七 v/o *to 

i\\t result 


int myResult = MultiplyTwoNumbers(3, 5); 
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objects: get oriented! 


u Clas 


BULLET POINTS 


■ 


■ 


■ 


■ 


ses have methods that contain statements that perform actions. You can design a class that is easy to use by 
choosing methods that make sense. 

Some methods have a return type. You set a method’s return type in its declaration. A method with a declaration that starts 
“public int” returns an int value. Here’s an example of a statement that returns an int value: return 37 ； 

When a method has a return type, it must have a return statement that returns a value that matches a return type. So if 
you’ve got a method that’s declared “public string" then you need a return statement that returns a string. 

As soon as a return statement in a method executes, your program jumps back to the statement that called the method. 

Not all methods have a return type. A method with a declaration that starts “public void” doesn’t return anything at 
all. You can still use a return statement to exit a void method: if (f inishedEarly) { return ； } 


Use what youVc learned to build a program that uses a class 


Let’s hook up a form to a class, and make its button call a method inside that class. 參 

o 



this! 




❺ 


Create a new Windows Forms Application project in the IDE. Then add a class file to it 
called Talker.cs by right-clicking on the project in the Solution Explorer and selecting “Class...” 
from the Add menu. When you name your new class file “Talker.cs，” the IDE will automatically 
name the class in the new file Talker. Then it’ll pop up the new class in a new tab inside the IDE. 

Add using System. Windows . Forms; to the top of the class file. Then add code to the class: 




class Talker { 

public static int BlahBlahBlah(string thingToSay , int numberOfTimes) 
{ 

TW»s 广 string finalstring 

— s a for (int count - 

vav'»aWc { 

“ ㈣ 切 fin.ISfrinrr = 




0; count < numberOfTimes; count++) 


MessageBox.Show(finalString); 


finalstring = finalstring + thingToSay + n \n"; 

This of todt adds -the 

return finalstring. Length; ^ 

The method’s value is variable, 

mtejev- that has the -total the message it 

displayed- ^ w *to a^y stv-'mj *to TK'is is tailed a pv-ofevty. stvm} 

ou-t how lo ^5 i*t is. 、一 a called 

tabulates {}\t ok d 3 Imc 

bv*Cdk 匕 ouyvts 3s oir\C 




Flip tke page to keep going! 
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introducing objects 


❺ 


o 


So what did you just build? 


♦ 


The new class has one method called BlahBlahBlah () that takes two parameters. The first 
parameter is a string that tells it something to say, and the second is the number of times to say 
it. When it’s called, it pops up a message box with the message repeated a number of times. 

Its return value is the length of the string. The method needs a string for its thingToSay 
parameter and a number for its numberOf Times parameter. It’ll get those parameters 
from a form that lets the user enter text using a TextBox control and a number using a 
NumericUpDown control. 

Sc-t default 

七 €% 七 of 

Ti% 七 Bo 乂 torrtvol *to 
w Hello"’ us'm^ its Te % 七 
pvopcvty. 


To turn off 
the minimize 
and maximize 
buttons, set 
the form’s 
MaximizeBox 
and 

MinimizeBox 
properties to 
False. 


Now add a form that uses your new class! 



t 


Talker Tester 


Say this: 

# of times: 


Make your project’s form look like this. 





Then double-click on the button and have it run this code that calls BlahBlahBlah () and assigns its return 
value to an integer called len: This is B ^oh-tvol. 

Set its Alihirnurw p\ropcv-ty -fco I, i-fcs 

private void buttonl Click (obj ect sender, EventArgs e) pv-opc\rty -to lO, its 

{ — Vdluc p\ropc\rty io 1>. 

int len = Talker•BlahBlahBlah(textBoxl•Text, (int)numericUpDownl.Value); 
MessageBox.Show("The message length is " + len); 


Now run your program! Click the button and watch it pop up two 
message boxes. The class pops up the first message box, and the 
form pops up the second one. 


The is 2-1 because w ttcllof 

is si% dhav-ad*tcvs, flus 
dourrts as dhav*ad*tcv-, 

whi 匕 h jives 7 x. ^ — Zl- 





The Bla^BlahBlaiiO mc-thod 

pops uf *this 你 essay bo% 

based oy\ v/hats ih i*ts 
fav-amc*tcv-s. 



I/Vhch the 
method \rctu\rhs 
a value, the -fov-m 

pops it Up ih this 
message box. v/* 





You can add a class to your project ami skare 
its metkocts witk tke otker classes in tke project. 


106 Chapter 3 




















































objects: get oriented! 


Mike gets m idea 

The interview went great! But the traffic 
jam this morning got Mike thinking about 
how he could improve his navigator. 



工 T，D 6rRBAT IF I 

A FEW) 

R^UTBS AND FI^URB 夕 UT 
WHI6H IS FASTBST.... 


He could create three different Navigator classes... 


Mike could copy the Navigator class code and paste it into two more 
classes. Then his program could store three routes at once. 


Navigator 

SetCurrentLocation() 

SetDestination() 

ModifyRouteToAvoid() 

ModifyRouteTolnclude() 

GetRoute() 

GetTi meToDesti nation 0 
TotalDistance() 


Navigator2 

SetCurrentLocation() 

SetDestination() 

ModifyRouteToAvoid() 

ModifyRouteTolnclude() 

GetRoute() 

GetTimeToDestination() 

TotalDistance() 


TWis box is a tlass diayam. |*t lists 

dll w>c*tV\ods \y\ 3 dlass ， 

*，Vs easy way bo see cvcv-ytWmj 
»*b docs a*t 3 —Me. ' 


Navigator3 

SetCurrentLocation() 

SetDestination() 

ModifyRouteToAvoid() 

ModifyRouteTolnclude() 

GetRoute() 

GetTimeToDestination() 

TotalDistance() 



VOH^A, THAT 6AM X T BB RI^HTi 
VOHAT IF I WAMT TO CHANTS A 
MBTH^D? 丁咖工 N55D TO &0 
BACK AND FIX IT IN TNR5B PUA6BS- 


Right! Maintaining three copies of the same code 
is really messy. A lot of problems you have to solve need a 
way to represent one thing a bunch of different times. In this case, 
it’s a bunch of routes. But it could be a bunch of people, or aliens, 
or music files, or anything. All of those programs have one thing in 
common: they always need to treat the same kind of thing in the 
same way, no matter how many of the thing they’re dealing with. 


you are here ► 
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for instance... 


Mike can use objects to solve his problem 


Objects are G# 5 s tool that you use to work with 
a bunch of similar things. Mike can use objects 
to program his Navigator class just once, but 
use it as many times as he wants in a program. 





Navigator 


SetCurrentLocation() 

SetDestination() 

ModifyRouteToAvoid() 

ModifyRouteTolnclude() 

GetRoute() 

GetTi meToDesti nation () 
TotalDistance() 


All you need to create an 
object is the new keyword 
and the name of a class. 


Navigator navigatorl 









Mike needed -fco dompav-e 
"thvee v*ouics 

_ at ot\Ct } so he used 

f ^igoX^ KolvigaW objects 



Navigator(); 


navigatorl. SetDestination ("Fifth Ave & Penn Ave ff ); 
string route; 


route =^aviqatorl. GetRoute 



Now you can use the object! When you 
create an object from a class, that object 
has all of the methods from that class. 
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objects: get oriented! 


You use a class to build an object 

A class is like a blueprint for an object. If you wanted to build 
five identical houses in a suburban housing development, you 
wouldn’t ask an architect to draw up five identical sets of 
blueprints. You’d just use one blueprint to build five houses. 



you dc-f mc a cUss, you dc-f mc 
•rts mC*tKods, jus 七 like a bluCfV-*m*t 
dc-f mcs i\\t layout o^c 七 he Kousc. 


Y^>u use OhC b!ucp\rih't "to 
你 ake hurv\be\r o-p houses ； 

3hd you t^t\ use OhC -to 
… ake humbc\r o-p objects. 


Aw object gets its methods from its class 


Once you build a class, you can create as many objects as you want from 
it using the new statement. When you do, every method in your class 
becomes part of the object. _ 



House 

GiveShelter() 

GrowLawn() 

MailDelivered() 

ClogDrainPipes() 

AccruePropertyTaxes() 

NeedRepairs() 
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objects improve your code 


Whew you create a new object from a class, 
it's called an mstawee of that class 

Guess what.. .you already know this stuff! Everything in the toolbox 
is a class: there’s a Button class, a TextBox class, a Label 
class, etc. When you drag a button out of the toolbox, the IDE 
automatically creates an instance of the Button class and calls 
it button 1. When you drag another button out of the toolbox, 
it creates another instance called button2. Each instance of 
Button has its own properties and methods. But every button acts 
exactly the same way, because they’re all instances of the same class. 


Bc-Pov-c ： hevVs a pidtuve o( youv 
donr»pu"tc\r ； s rwerwovy y/hch youv- 
p\roJV-anr» s-ta\rts. 




r 


p 化 3 心 

c^c^u-tes a hCW 


House mapleDrivell5 = new House(); 


Check it out for yourself! 


aot 

tlass m wCwov'y* 



參 


this! 


115 Maple 
Drive 


Open any project that uses a button called button 1 ， 
and use the IDE to search the entire project for the 
text “buttonl = new”. You’ll find the code that 
the IDE added to the form designer to create the 
instance of the Button class. 


in-stance^ noun. 

an example or one occurrence of 
something. The IDE search -and- 
TcplaccJeatuTeJiuds eveiy iftstaficc 
°f a wor d and changes it to another. 
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objects: get oriented! 


A better solutiow...brought to you by objects! 

Mike came up with a new route comparison program that uses objects to find 
the shortest of three different routes to the same destination. Here’s how he 
built his program. 


与 W stands -Po\r ^v-aphidal 

Ww whidh is 


what youVc buildi% wheh 
Y ou a -Pov-rn ih the 
/ -ro\rm desi^hev-. 


❶ 

❺ 


Mike set up a GUI with a textbox — t ext Box 1 contains the destination for the three routes. 
Then he added textBox2, which has a street that one of the routes should avoid; and 
textBox3, which contains a different street that the third route has to include. 


He created a Navigator object and set its destination. 


TKc ^av'i^a-tov-l 
objet-t »s an 
ms-tay\tc o-f 七 he 
Kav'i^a-tov- tlass. 


Navigator 


SetCurrentLocation() 

SetDestination() 

ModifyRouteToAvoid() 

ModifyRouteTolnclude() 

GetRoute() 

GetTi meToDesti nation () 
TotalDistance() 


f navigator 

3.5 miles / X) i 


string destination = textBoxl.Text; 
Navigator navigatorl = new Navigator() 
navigatorl .SetDestination(destination) 
route = navigatorl .GetRoute(); 


❺ 

o 




Then he added a second Navigator object called navigator2. He 
called its SetDestination () method to set the destination, and 
then he called its Modif yRouteToAvoid () method. 




oav-a^ctcv- 


The third Navigator object is called navigator3. Mike set its / __ 

destination, and then called its Modif yRouteTo Include () method. 



navigatorl 

3.5 miles i "P 


navigator2 

3.8 miles J 


navigator3 

4.2 miles i 

^5^ 


Any time you 
create a new 
object from a 
class ， it’s callect 


Now Mike can call each object’s TotalDistance () method to figure 
out which route is the shortest. And he only had to write the code once, 
not three times! 


creating an 
instance of 
tkat class. 
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a little head first secret sauce 



o 



WAIT A MINUTBi YOU 
DIDN，T dlVB MB MBARUY 
INF^EMATI^N TO BUIUD THE 
NAVI^AT^E 


That’S right，we didn’t. A geographic navigation program is 
a really complicated thing to build. But complicated programs follow 
the same patterns as simple ones. Mike’s navigation program is an 
example of how someone would use objects in real life. 


Theory and practice 

Speaking of patterns, here’s a pattern that you’ll see over and over again 
throughout the book. We’ll introduce a concept or idea (like objects) over the 
course of a few pages, using pictures and short code excerpts to demonstrate the 
idea. This is your opportunity to take a step back and try to understand what’s 
going on without having to worry about getting a program to work. 

House mapleDrivell5 = new House(); 

y/cVc *m*tvodiud'mg 3 mcv/ 

(like objcd*ts), keep you\r eyes open -fov- 
pid*tu\rcs By\A toAt cxdcvpt like 

After we’ve introduced a concept, we’ll give you a chance to get it into your 
brain. Sometimes we’ll follow up the theory with a writing exercise — like the 
Sharpen your pencil exercise on the next page. Other times, we’ll jump straight 
into code. This combination of theory and practice is an effective way to get 
these concepts off of the page and stuck in your brain. 

A little advice for the code exercises 

If you keep a few simple things in mind, it’ll make the code exercises go 
smoothly: 

★ It’s easy to get caught up in syntax problems, like missing parentheses 
or quotes. One missing bracket can cause many build errors. 

★ It’s much better to look at the solution than to get frustrated with a 
problem. When you’re frustrated, your brain doesn’t like to learn. 

★ All of the code in this book is tested and definitely works in Visual 
Studio 2012! But it’s easy to accidentally type things wrong (like 
typing a one instead of a lowercase L). 

★ If your solution just won’t build, try downloading it from the Head 
First Labs website: http:/ / wzvzv.headfirstlabs.com/hfcsharp 


"15 Maple 、 


Wken you run into 
a problem witk 
a coding exercise ， 
don’t be afraid 
to peek at tke 
solution. You can 
also ctownload tke 
solution from tke 

Head First Lal>s 
website. 
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c^^rpen your pencil 


Follow the same steps that Mike followed earlier in the chapter to write 
the code to create Navigator objects and call their methods. 

string destination = textBoxl. Text; ihe KlltZL wiThe 

string route2StreetToAvoid = textBox2 . Text; \ st 代 rt har^es A *。 州 

string route3StreetToInclude = textBox3 . Text; ) the text boxes. 


Navigator navigatorl = new Navigator(); 
navigatorl.SetDestination(destination); 
int distancel = navigatorl.TotalDistance(); 



/W “re’s 七 v^ode 〜 —c 十 

object set dcstmat.^, 
arsd distaste. 


1. Create the navigator2 object, set its destination, call its Modif yRouteToAvoid () method, and 
use its TotalDistance () method to set an integer variable called distance2. 


1 


I Navigator navigator2 
I navigator2. 


navigator2 


int distance2 


L 


2. Create the navigator3 object, set its destination, call its Modif yRouteToInclude () method, 
and use its TotalDistance () method to set an integer variable called distance3. 


J 


1 


L 




j 



int shortestDistance = Math.Min(distancel^ Math.Min(distance2 A distance3)); 
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c^^rpen your pencil 


Follow the same steps that Mike followed earlier in the chapter to write 
the code to create Navigator objects and call their methods. 


string destination = textBoxl.Text; 
string route2StreetToAvoid = textBox2.Text; 
string route3StreetToInclude = textBox3.Text 

Navigator navigator1 = new Navigator(); 
navigatorl.SetDestination(destination); 
int distancel = navigatorl.TotalDistance(); 




^ ^ you a head sia^rt fWs 
the todt Mike v/\roie -to get the 
dcs-tmatioh av\d street 

the text boxes. 


/W s todt {p ertait 

object, set dcstm 冼⑽， 

ay\d d'»s*ta^c. 


1. Create the navigator2 object, set its destination, call its Modif yRouteToAvoid () method, and 
use its TotalDistance () method to set an integer variable called distance2. 


1 


I Navigator navigator2 


new Navioja^tovO 


navigator2. 
navigator2. 




A1odi-fyRou*tc"Io/\voidl(v-ou*tcZS*tv"CC*tToAvoidl)j 


int distance2 


^aviga^bov-ZTo-talDista^dcO; 


L 


2. Create the navigator3 object, set its destination, call its Modif yRouteToInclude () method, 
and use its TotalDistance () method to set an integer variable called distance3. 

Navi^a*bov- ^avi^a^bov-? — 灼 cw Kavicja^bov-O 


J 


1 


^aviga'bov^Sc*tDcs*t*ma*tio^(dcs*t*ma*tio^)； 


^avi^a-bo\r5./l/lodii-fyRou*tcTo|^dludc(v-ou*tc3S*t\rcc*t"fo|^dludc)j 


•m 七 distande 孓二 ^aviga*tov*3.7o*talDis*ta^dcO; 


L 




j 



int shortestDistance = Math.Min(distancel^ Math.Min(distance2 A distance3)); 
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工 WRITTBM A FBVJ CUASSBS M^W, BUT 工 
HAVBM^ USBD ' V NBW ,/ TO 6RBATB AM INSTAM6B 
VBTL SO l>OBS THAT I 6AM 6AUU METHODS 

WITHOUT 6RBATIN^ OBJBCTST 



Yes! That’s why you used the static keyword in your methods. 

Take another look at the declaration for the Talker class you built a few pages ago: 


class Talker 


public static int BlahBlahBlah(string thingToSay, int numberOfTimes) 
{ 

string finalstring =""; 

When you called the method, you didn’t create a new instance of Talker. You just did this: 
Talker.BlahBlahBlah("Hello hello hello", 5); 

That’s how you call static methods, and you’ve been doing that all along. If you take away 
the static keyword from the BlahBlahBlah () method declaration, then you’ll have to 
create an instance of Talker in order to call the method. Other than that distinction, static 
methods are just like object methods. You can pass parameters, they can return values, and 
they live in classes. 

There’s one more thing you can do with the static keyword. You can mark your whole 
class as static, and then all of its methods must be static too. If you try to add a nonstatic 
method to a static class, it won’t compile. 


D 


there jar 

>umb 


e no o 

Questions 


When I think of something that’s “static,” I think of 
something that doesn’t change. Does that mean nonstatic 
methods can change, but static methods don’t? Do they 
behave differently? 

No, both static and nonstatic methods act exactly the 
same. The only difference is that static methods don’t require 
an instance, while nonstatic methods do. A lot of people have 
trouble remembering that, because the word “static” isn’t really 
all that intuitive. 

So I can’t use my class until I create an instance of 
an object? 

You can use its static methods. But if you have methods 
that aren’t static, then you need an instance before you can 
use them. 


Then why would I want a method that needs an 
instance? Why wouldn’t I make all my methods static? 

Because if you have an object that’s keeping track of 
certain data—like Mike’s instances of his Navigator 
class that each kept track of a different route—then you can 
use each instance’s methods to work with that data. So when 
Mike called his ModifyRouteToAvoid () method 
in the navigator2 instance, it only affected the route 
that was stored in that particular instance. It didn’t affect the 
navigatorl or navigator3 objects. That’s how he 
was able to work with three different routes at the same time— 
and his program could keep track of all of it. 

So how does an instance keep track of data? 

A! Turn the page and find out! 
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an object’s state of affairs 


An instance uses fields to keep track of things 


You change the text on a button by setting its Text property in the 
IDE. When you do, the IDE adds code like this to the designer: 

buttonl.Text = "Text for the button"; 

Now you know that buttonl is an instance of the Button class. 
What that code does is modify a field for the buttonl instance. 



Tc^hhidally, i-ts sc-t-tmg a 
pCOpeir 七 y . P\ropc\rty is vcv-y 

-to a -fidd-bu-t well 
get ih-to all that a liUlc 

latcir Oh. 


You can add fields to a class diagram — just draw a horizontal line in 
the middle of it. Fields go above the line, methods go underneath it. 


Tins is v/iicvc a dass 
did^v-dm sKov/s {}\t 〆 
-fields. Evcvy 
of dlass uses 


bo keef brack 
its s*ta 七 e. 






Add "this lihe "to 

the fields 
-rv-om -the methods. 


Methods are what an object does. Fields are what the object jewows. 

When Mike created three instances of Navigator classes, his program created three objects. 

Each of those objects was used to keep track of a different route. When the program created the 
navigator2 instance and called its SetDestination () method, it set the destination for that 
one instance. But it didn’t affect the navigator 1 instance or the navigator3 instance. 


Navigator 

Destination 

Route 

SetCurrentLocation() 

SetDestination() 

ModifyRouteToAvoid() 

ModifyRouteTolnclude() 

GetRoute() 

GetTi meToDesti nation () 

TotalDistance() 

— 



^vevy ms*t3n£.C o( N 3 vi^a*tov kr>o>ws 
i*ts dcs*tma*tior\ and I*ts vou*tc- 


3 /^aviga*to\r object docs is 
let you set d dcs-t'matioh, rwodi-fy 
i"ts 3hd •nvpovrwa 七 ioh 

about that \routc. 


An object’s tekavior is ctefined ty its metkocts, 


and it uses iields to keep track ol its state. 
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Let's create some mstances! 

It’s easy to add fields to your class. Just declare 
variables outside of any methods. Now every 
instance gets its own copy of those variables. 


see 


Rcmcmbcn whch you 

: i “ Mht a method, 

，t mcahs that it docs^i 
^c-tu^rh ahy value. 




class Clown { 

public string Name; 
public int Height; 

public void TalkAboutYourself() 
MessageBox.Show("My name is " 
+ Name + ’▼ and I'm ’▼ 

+ Height + ’▼ inches tall." 


1/VliCh you Wol^t -to d\rcatc ihS-tolh^s 
yo^ 匕 lass, do^-fc use the s-tatid 
keyword ci-thc\r the dass dedawtioh 
o\r -the method dc^lav-atioh. 

i^^rpen your pencil — 


\1/ 


Remember i\\t ofC\ra*toV *WU C# 

-fco -take y/ha 七 ew’s o 灼 iiic o( {}\t 
opev-a-tov dv>d multiply *i*t by y/i^a*tcvcrs 
or> vi# 七 . 


Write down the contents of each message box that will be displayed 
after the statement next to it is executed. 


Clown oneClown : 
oneClown.Name = 
oneClown.Height 


new Clown() 
Boffo n ; 

: 14; 


oneClown.TalkAboutYourself(); 

Clown anotherClown = new Clown(); 
anotherClown.Name = "Biff"; 
anotherClown.Height = 16; 

anotherClown.TalkAboutYourself(); 

Clown clown3 = new Clown(); 
clown3.Name = anotherClown.Name; 
clown3.Height = oneClown.Height - 3 

clown3.TalkAboutYourself(); 


'My name is 


and I’m 


inches tall.” 


'My name is 


and I’m 


inches tall: 


'My name is 


and I’m 


inches tall.” 


anotherClown.Height 




2 ; 


anotherClown.TalkAboutYourself() 


'My name is 


and I’m 


inches tall.” 
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toss it in the heap 


Thanks for the memory 


When your program creates an object, it lives in a part of the 
computer’s memory called the heap. When your code creates an 
object with a new statement, G# immediately reserves space in the 
heap so it can store the data for that object. 



Hcvc s d pitWc kaf behove 

pv-ojct*b s*bav*b. Notice »*b s cmp*by- 


Let's take a closer look at what happened here 


c^terpen your pencil 




Clown oneClown 
oneClown . Name = 
oneClown.Height = 14; 

oneClown.TalkAboutYourself() 

Clown anotherClown ^new Clown() 
anotherClown.Name = n Biff . 
anotherClown.Height = 16; 

anotherClown.TalkAboutYourself() 

Clown clown3 = 
clown3.Name = anotherClown.Name; 
clown3.Height = oneClown.Height - 3 

clown3.TalkAboutYourself(); 



Write down the contents of each message box that will be displayed 
after the statement next to it is executed. 

bf 上:； £freaies „心 〆 心。。灿 

”妞 y 』 s d 唧“ w 

My name is and Tm —_ I 午 inches tall." 


anotherClown.Height 




2 ; 


anotherClown.TalkAboutYourself() 


My name is m _ and Tm ____ inches tall. 


'My name is _ and I’m __(1_inches tall. 


'My name is _and Tm ― Jz — inches tall. 


Wken your program creates a new object, it gets actdect to tke keap* 
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What's ow your program's mmd 


丁 iVis objc^*t 
Cloy/r\ dUss. 


Clown oneClown : 
oneClown.Name = 
oneClown.Height 


new Clown(); 
Bof f o n ; 

: 14; 




oneClown.TalkAboutYourself(); 


Clown anotherClown = new Clown(); 

anotherClown.Name = "Biff"; d\rcatc 

the sedo^d object ay\d till it 

anotherClown . Height = 16; wi 七 h ^ 

anotherClown.TalkAboutYourself(); 


❺ Clown clown3 
clown3.Name : 


'Biff 
11 


: new Clown(); 
anotherClown.Name 


V 

c Kn 


Here’s how your program creates a new instance of the 
Clown class: 


Clown mylnstance = new Clown(); 

That’s actually two statements combined into one. The 
first statement declares a variable of type Clown (Clown 
mylnstance;). The second statement creates a new 
object and assigns it to the variable that was just created 
(mylnstance = new Clown ();). Here’s what tj>emeap 
looks like after each of these statements: 


clown3.Height = oneClown.Height - 3; 
-clown3.TalkAboutYourself(); ,. 

treated a e 


O anotherClown.Height *= 2; 

-anotherClown.TalkAboutYourself(); 


T\\trts y\o 

meav>s -these s-tci-tcmc^-ts do 灼’七 dvca*tc a 
y>ev/ objedt ThcyVc jus 七 rnodi-fym^ oy>c 
七 hat’s already m memovy. 〜—- 
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making methods make sense 


You can use class and method 
names to make your code intuitive 

When you put code in a method, you’re making a choice about how to structure 
your program. Do you use one method? Do you split it into more than one? Or do 
you even need a method at all? The choices you make about methods can make your 
code much more intuitive — or, if you’re not careful, much more convoluted. 

o Here’s a nice, compact chunk of code. It’s from a control program that 
runs a machine that makes candy bars. 


匕 


t 丄 L" U •▲衫 ^ j U " 

VO ) \tS ； 扣 d rr\ 

a\rc *tc\rv-iblc r\3n\cs! 
IVc have y\o idea 一 
y/ha 七七 hey do. /W 
y/haVs T dass 

-for? 


int t = m.chkTemp() 
if (t > 160) { 

T tb = new 
tb.clsTrpV^2) 
ics.Fill (); 
ics.Vent(); 
m.airsyschk(); 


㉟ ^ 






TKc dsTir\A/() 

method V^as or\c 

ku*t 

do^*t ky\o>w v/ha 七 

•rt’s supposed *to kc. 


Great developers 
write code 
tliat’s easy to 
understanct. 
Comments can 
kelp, tut notkingf 
teats ckoosingf 
intuitive names 
lor your metkocts, 
classes ， variables ， 
and iields. 


Take a second and look at that code. Can you figure out what it does? 


❺ Those statements don’t give you any hints about why the code’s doing what it’s doing. In this case, the 
programmer was happy with the results because she was able to get it all into one method. But making 
your code as compact as possible isn’t really useful! Let’s break it up into methods to make it easier to 
read, and make sure the classes are given names that make sense. But we’ll start by figuring out what the 
code is supposed to do. 


^ CoAt 

Well, all todc W 

a y-casom. So ^ ^ 


General Electronics Type 5 Candy Bar Maker 

Specification Manual 

The nougat temperature must be checked every 3 minutes by an 
automated system. If the temperature exceeds 160°C, the candy 
is too hot, and the system must perform the candy isolation 
cooling system (CICS) vent procedure. 

• Close the trip throttle valve on turbine #2. 

• Fill the isolation cooling system with a solid stream of water. 

• Vent the water. 

• Verify that there is no evidence of air in the system. 
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That page from the manual made it a lot easier to understand the code. It also gave us some great 
hints about how to make our code easier to understand. Now we know why the conditional test checks 
the variable t against 160 — the manual says that any temperature above 160°G means the nougat 
is too hot. And it turns out that m was a class that controlled the candy maker, with static methods 
to check the nougat temperature and check the air system. So let’s put the temperature check into a 
method, and choose names for the class and the methods that make the purpose obvious. 


publiciUooolearr IsNougatTooHot () 


TVic IsNou^atTootto-tO 
method's •bype 


int temp 
if (temp 
return 
} else { 
return 

} 


=Maker.CheckNougatTemperature(); 

> 160) { T Bv tlass w yviakc/ a^d 

true; 



wa kc codt a lot easier to 


y/c 

ur\dcv-s*tay\d. 


i*t V"C*t^ir\S 3 

ir\At ov -false value- 



What does the specification say to do if the nougat is too hot? It tells us to perform the candy isolation 
cooling system (or GIGS) vent procedure. So let’s make another method, and choose an obvious name 
for the T class (which turns out to control the turbine) and the ics class (which controls the isolation 
cooling system, and has two static methods to fill and vent the system): 


f void irctuirh type ^cav\s 
"the method docsh ； *t 
av\y value at all. 


public \void )DoCICSVentProcedure () { 

Turbine turbineController = new Turbine () 
turbineController . CloseTripValve (2); 

工 solationCoolingSystem.Fill(); 


IsolationCoolingSystem.Vent(); 
Maker.CheckAirSystem(); 



Now the code’s a lot more intuitive! Even if you don’t know that the GIGS vent procedure needs to 

be run if the nougat is too hot, it’s a lot more obvious what this code is doing: 


if ( 工 sNougatTooHot () == true) { 
DoCICSVentProcedure(); 


You can make your cocte easier to react and write ty tkinking about 
tke problem your cocte was tuilt to solve. II you ckoose names ior your 
metkocts tkat make sense to someone wko uiufcrstancls tkat protlem, 
tken your code will te a lot easier to cteciplter...anct ctevelop! 
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classes au naturale 


ftive your classes a natural structure 


Take a second and remind yourself why you want to make your methods intuitive: 
because every program solves a problem or has a purpose. It might not 
be a business problem — sometimes a program’s purpose (like FlashyThing) is just to 
be cool or fun! But no matter what your program does, the more you can make your 
code resemble the problem you’re trying to solve, the easier your program will be to 
write (and read, and repair, and maintain...). 


Use tlass diaya^s -to ou-t your dasscs 


A dlass dia^am is a simple ^ ^ ^ 

classes ou-t or> \>a\>cv. \{!S a v-cally valuable W 

U codt mORt you sWt 

1 七 . 

VVv'rtc dlass at *to? 

如 dia^am. TKcr> cadK metw m 
W aUk botw- Noy/ you ^ sec all 0+ 
prts d 七 dlass a 七 a 


ClassName 


Method () 
Method() 
Method () 


Let's build a class diagram 

Take another look at the if statement in #5 on the previous page. You already know that statements 
always live inside methods, which always live inside classes, right? In this case, that if statement was 
in a method called DoMaintenanceTests (), which is part of the CandyController class. 
Now take a look at the code and the class diagram. See how they relate to each other? 


class CandyController { 

public void DoMaintenanceTests() { 

參參參 

if (IsNougatTooHot () == true) { 
DoCICSVentProcedure(); 

} 

參 • • 

} 

public void DoCICSVentProcedure() 
public boolean IsNougatTooHot().. 



_CandyController 

DoMaintenanceTests() 

DoCICSVentProcedure() 

lsNougatTooHot() 
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c^^rpen your pencil 


The code for the candy control system we built on the previous 
page called three other classes. Flip back and look through the 
code, and fill in their class diagrams. 
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picture your classes 

Class diagrams help you organize your 
classes so they make sense 

Writing out class diagrams makes it a lot easier to spot potential problems in your 
classes before you write code. Thinking about your classes from a high level before 
you get into the details can help you come up with a class structure that will make 
sure your code addresses the problems it solves. It lets you step back and make sure 
that you’re not planning on writing unnecessary or poorly structured classes or 
methods, and that the ones you do write will be intuitive and easy to use. 


Dishwasher 


Dishwasher 

CleanDishes() 

The class is called 

CleanDishes() 

AddDetergent() 

Dishwasher, so all the 

AddDetergent() 

SetWaterTemperature() 

ParkTheCar() 

methods should be about 

method — ParkTheCar () — 
has nothing to do with dishes, 
so it should be taken out and 
put in another class. 

SetWaterTemperature() 


c^terpen 


lencil 


your penci 

ion The code for the candy control system we built on the 丨 ：y wt tHat 

llv U t v previous page called three other classes. Flip back and ,s a 乙 bss because it 

look through the code, and fill in their class diagrams, ^ppcav-s Wof\t ox a dot ih 

A/lakc\r.Chc^kAi\rSystcrhO. 


Turbine 


CloseT\rip\/alveO 



I soUtiOh Cool ih^Sys-ter^ 


FillO 


\/e 灼七 0 


— 


Maker 






Oiedk/WSys 七加 0 
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c^^rpen your pencil 


Each of these classes has a serious design flaw. Write down what 
you think is wrong with each class, and how you’d fix it. 


Class23 

CandyBarWeight() 

PrintWrapper() 

GenerateReport() 

Go() 


— 


This class is part of the candy manufacturing system from earlier. 


DeliveryGuy 

AddAPizza() 

PizzaDelivered() 

TotalCash() 

ReturnTime() 

DeliveryGirl 

AddAPizza() 

PizzaDelivered() 

- TotalCash() 

ReturnTirneQ 




These two classes are part of a system that a pizza parlor uses to 
track the pizzas that are out for delivery. 


CashRegister 

MakeSale() 

NoSale() 

PumpGas() 

Refund() 

TotalCashlnRegister() 

GetTransactionList() 

AddCash() 

RemoveCash() 

— 


The CashRegister class is part of a program that's used by an 
automated convenience store checkout system. 
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create a class 


c^^rpen your pencil 


Here’s how we corrected the classes. We show just one 
possible way to fix the problems — but there are plenty of other ways 
you could design these classes depending on how they’ll be used. \ 


This class is part of the candy manufacturing system from earlier. 

The dass name doesn't desdv-ibe what -the dlass docs. /\ pv-ojv-ammev- 

y/ho sees d Imc o-f todt ddlls Classic.^oO will have y\o idea v/ha*t 
Imc does. Wtd also method *to somethmj •bhaVs mo\rc 

descriptive — wc MakcThcCa^dyO, bu*t i*t ^ould be 


CandyMaker 

CandyBarWeight() 

PrintWrapper() 

GenerateReport() 

MakeTheCandyQ 


These two classes are part of a system that a pizza parlor uses to 
track the pizzas that are out for delivery. 

I 七 looks like Delivery 今 uy dass -the Ddivcv-y^iv-l dass 

bo*th do same — 七 hey *tv~adk 3 ddivcv-y pe\rso 灼 who’s ou 七 

dclivc\r*mj pz^as *to dus*tor»\C\rs. f\ bc*t*tc\r desi^ would \rcfladc 

-them W\{\\ a sm^lc dlass *tha*t adds a -field -fov- jc^dcv-. 



AddAPizza() 

PizzaDelivered() 

TotalCash() 

ReturnTime() 




y/c 


auys sc\>a^ra*tclv, ayvd s v/V>y 



The CashRegister class is part of a program that’s used by an 
automated convenience store checkout system. 

All of methods \y\ dldss do has *to do y/i-th 

d ddsh \rc^is*tc\r—makmj a sale ； a lis*t *tv"a^sad*tio^s, 

addmj -fov- oy\c <jds. a good idea *to pull 

*tha*t method ou*t and S*ti^k i*t m a^o*thc\r t\Bss. 


CashRegister 

MakeSale() 

NoSale() 

Refund() 

TotalCashlnRegister() 

GetTransactionList() 

AddCash() 

RemoveCash() 

— 
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public partial class Forml : Form { 
public Forml() { 

InitializeComponent(); 

} 

private void buttonl_Click(object sender, EventArgs e) 
string result = 


Echo el = new Echo (); 


int x = 0; 

while ( _ ) { 

result = result + el.Hello () + "\n"; 


if ( _ ) { 

e2.count = e2.count + 1; 

} 

if ( _ ) { 

e2.count = e2.count + el.count; 

} 

X = X + 1 ; 

} 

MessageBox. Show (result + "Count : ’▼ + e2 . count); 

} 

} 

class _ { 

public int _ = 0; 

public string _ { 


return "helloooo... M ; 



Puzz]e 

Your job is to take 
code snippets 
from the pool and 
place them into the blank 
lines in the code. You may use the same 
snippet more than once, and you won’t 
need to use all the snippets. Your goal is to 
make classes that will compile and run and 
produce the output listed. 


Output 



heliooaD... 
hell ⑽ oo、" 
heiiooaD,., 
helloo&e,.. 
Count 10 


OK 


Bonus Question! 

If the last line of output was 
24 instead of 10, how would 
you complete the puzzle? 
You can do it by changing 
just one statement. 



There are two possible solutions to this puzzle. Can you find them both? 


















working class guys 


Puild a class to work with some guys 


Joe and Bob lend each other money all the time. Let’s create a class to 
keep track of them. We’ll start with an overview of what we’ll build. 


o We'll create a Guy class and add two instances of it to a form, 

The form will have two fields, one called joe (to keep track of the first object), 
and the other called bob (to keep track of the second object). 


trcait ~ 

msta^cs live m ^ 

codt _ as 

soov\ as i\\t is 
c.v-ca*tcd. Hcv-cs 

i\\t looks like 

-fovw \s 

loaded- 



G °y ob\^ 



o We’ll set each Guy object’s cash and name fields. 

The two objects represent different guys, each with his own name and a 
different amount of cash in his pocket. 


Guy 

Name 

Cash 


GiveCash() 

ReceiveCash() 



lA/c dhosc -Pov "the 

methods -that make sc^sc- 
You dal I a 今 uy objects 
^ivcCashO method *to tell 

hinr» h> jive up somst his 
dash, a^d his RcdcivcCashO 
rwethod >wliCh you him 

{jo take sonr>c badk. 

1/Vc dould have called -them 
^ivcC^shloSoi^co^cO dhd 
RcdcivcC3shF\ror>r»Sonf»co^cO, 
but 七 hat v/ould have beeh 



Eadh juy has a Name 
-field that keeps -tvadk o( 
his v\a^, and a Cash -field 

"the hurwbcV" o-(* 
budks *m his pocket 



❺ We'll give cash to the guys and take cash from them. 

We’ll use each guy’s ReceiveCash () method to increase a guy’s cash, 
and we’ll use his GiveCash () method to reduce it. 



nc tails -tV^c Rtc^tCa^O 

w c^od. Its called RcdcWcCasV^Ob^ausc 
V^cs vcdcW'm^ *bV\c tasW ^ 

> bob.ReceiveCash(25) 


The rweihod vetuv-^s ihc 


^umbev- of budks -thai the guy 
added "to his Cash -field- 



vcv-y \oy\^1 


]/\l\\tr\ you *take a 灼 ms-ta^c 
<Jc ^uy 3r\d dall »*b 
RctcivcCasliO you 

pass 七 he arwour\*t o-f C^s\\ 

七 he yy Will take as a 
favarwc*tcv. So bob. 

RcctwCa^CV?) -tells Bob 
*to vctcivc 2-^ butks and 
add bo iiis wallet 
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Create a project for your guys 


Create a new Windows Forms Application project (because we’ll 
be using a form). Then use the Solution Explorer to add a new 
class to it called Guy. Make sure to add “using System. 
Windows . Forms to the top of the Guy class file. Then fill 
in the Guy class. Here’s the code for it: 




thi 


IS! 


— 


class Guy { 

public string Name; 
public int Cash; 



The 今 uy dlass has -two -fields. The Name -field is 
^ a^d itll dorrta.m 七 he Juy^s (“Joe"). 

"the Cash -field is m-t, will keep 
*bradk o*f how n\dv\y budks aire m his podke 七 . 

TKc ^.vcCasKO mctKod Kas o^c 

tailed youll use -to tell the 

Kov/ w»u£.K tasK *bo Y ou， 

public int GiveCash(int amount) { 

if (amount <= Cash && amount >0) { 

T\\t ^uy makes / > Cash -= amount; 
suve i\\Bi youVc return amount ; 

aski^ iiim (or a } else { 

positive ar^ou^t o MessageBox. Show ( 

’工 don't have enough cash to give you 1 

e t a 丄 .'r Name + ▼’ says •••"); 

cas\\ mstcad o\ J * 

■tak'mj a^ay return 0 ; the guy doesh i have chough hdl 

it } you SO wi-th a message box, a^d thch 

} k II r^akc ^ivcCashO v-cluv-h O. 


tte uses staW ⑼ t *to c\\tck 

Y/Kc-tKc^r V>c Kas c 一 W 」 
docs, V>c -bakes »*t ou*t o-f V^'is ^odket a^d 

\i as due. 


amount r 


public int ReceiveCash(int amount) 
if (amount >0) { 

Cash += amount; 
return amount; 

} else { 

MessageBox.Show(amount + 


"Uc RctcWcCas^O 州 rthod y/ov-ks jus*t l»kc 
命 vcCas 以） mrtUd. It、passed 扣 
a^ouy.1 as a f ara 州 c 七吖 , tMttVs -to make 
sure amount »s yrtaitr 
a^d h\tv\ adds *rt -to V^is casW 


Lsn r t an amount I r 11 take 



Name + n says... n ); 

return 0; W the amount was positive, th ⑶七 he 



Be ^a\rc-Pul With you\r t^\y bv^k 士 . ft’s easy 

wirohg hurhbc\r-n，akc suv»c ihai cvcv-y ofChiha 
bv^dkei has a wUhmg dosmg b\ra^kct IA/hch thcyVc 
^ hbhded, the IDE will au-tomati^lly \y\dcv\i thcr« 

+o\r you whch you type the last dos\^ Watkct 


RcdcivcCashO method \rc*tu\rir>s -the dr^ourrt 
added. |*f i 七 v/3s zjcv-o ov- negative, -the guy 
shows d messd^e box. and v-c*tuv-r>s O. 


What happens if you pass a 
negative amount to a Guy object’s 
ReceiveCash() or GiveCash() method? 
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joe says, “where’s my money?" 


Puild a form to interact with the guys 


The Guy class is great, but it’s just a start. Now put together a form that uses two 
instances of the Guy class. It’s got labels that show you their names and how much cash 
they have, and buttons to give and take cash from them. They have to get their money 
from somewhere before they can lend it to each other, so we’ll also need to add a bank. 


o 


© 




Build this! 


Add two buttons and three labels to your form. 

The top two labels show how much cash each guy has. We’ll also add a field called bank to the 
form — the third label shows how much cash is in it. We’re going to have you name some of the 
labels that you drag onto the forms. You can do that by clicking on each label that you want 
to name and changing its “(Name)’’ row in the Properties window. That’ll make your code a 
lot easier to read, because you’ll be able to use “joesCashLabel” and “bobsCashLabel” instead of 
‘labell” and “label2”. 


Fun with Joe and Bob 


This button will I 

the Joe object’s 
Rc^civcCashO method, 
passing it 10 as 
the clmouh-t, dhd 

-fvom -the 
+o\rm s bahk -Field the 

匕 that Joe v*cdcivcs. 



TV»c bank has 


the top label 
jocsCashLaM, -the bbel 

it bobsCashLabel, 
3hd the bottom label 
bahkCashLabcl. V^>u 
I ㈡ ve i\\6r Text pv-opcv-tics 
alohe; well add a method -to 

"the -Po\rrh -to set therw. 


This bu-t-fcoh will ddll "the Bob 
obje^s ^ivcCashO mcihod, 
pdss'm^ i-t ^ as -the arwoujvt ， 
addi^j -the dash ihai Bob gives 
b> the •Pornr/s bank -field. 


Add fields to your form. 

Your form will need to keep track of the two guys, so you’ll need a field for each of them. Gall 
them joe and bob. Then add a field to the form called bank to keep track of how much money 
the form has to give to and receive from the guys. 


namespace Your_Project_Name { 
SmtC V"C usm^ public partial class Forml 

今 uy objects *bo 

keef WacV ^_ V Guy joe; 


Form 


JoC Bob 

you dctlavc 


•tiiciv- -fields m 
-fovm usm^ 
i\\t ^uy dlass. 



public Forml() { 

InitializeComponent(); 

} 


"The o-f 

"the -fo\rm ； s bdhk 
•field goes up ahd doy/h 

dcpChdih^ oh how mu 匕 h 
你 0 甿 y the -fov-m gave -to 
ahd Reived -fv-orn the 
与认 y objects. 
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❹ 


into the form right underneath where you added the bank field: 
public void UpdateForm() { 


h/oiidc how -the labels 

^ updated usih0 the 
与 uy Name av\d 

Cash -fields. i 


o 


Add a method to the form to update the labels. 

The labels on the righthand side of the form show how much cash each guy has and how much 
is in the bank field. So add the UpdateForm () method to keep them up to date — make sure 
the return type is void to tell G# that the method doesn’t return a value. Type this method 

This y\t^i method 
is simple. H jus-t 
updates 七 he ihv-cc 
labels by settmg 
七 heiv Tivct p\ropc\rtics. 
You’ll have cbcM 
butioh tall it to keep 
ihc labels up -to daic- 

Double-click on each button and add the code to interact with the objects. 

Make sure the lefthand button is called button 1， and the righthand button is called button2. 

Then double-click each of the buttons — when you do, the IDE will add two methods called 
buttonl Click () and button2 Click () to the form. Add this code to each of them: 


joesCashLabel.Text 
bobsCashLabel.Text 
bankCashLabel.Text 


j oe. Name + " has $▼' 
bob.Name + " has $▼' 

"The bank has $" + bank; 


+ j oe.Cash; 
+ bob.Cash; 



You already 
know that 
you can 
choose 
names for 
controls. 
Are 

buttonl 

and 

button2 
really the 
best names 
we can find? 
What names 
would you 
choose 
for these 
buttons? 


private void buttonl_Click(object sender, EventArgs e) { 

if (bank >= 10) { 〉 -the usev didcs the flO h> 

bank -= j oe. ReceiveCash (10) ; > but-fcoh, the -fov-m C ， a\\s -the J< 

UpdateForm(); \ 


else { 

MessageBox.Show("The bank is 


L ) n GdllS XhC \JOt 

R^civcCashO method-but ohly 

I 七 lie bdhk has Chough mohey* 


out of money. n ); 

\ Thc bank Y\ttds ai least flO -to yve -to 
Joe- l-f 七 hire’s r>o 七 i*t1l fof uf 

•this message bo%. 

private void button2 Click(obj ect sender, EventArgs e) 


bank += bob.GiveCash(5) 


UpdateForm() 


/V TV^c w Rc^cWc Bob” butbm 

vL doesn't v\ttd bo \\o^i mu 乩 is 

*m bank, because iVll just add r 

——l ⑵以二 。, 


@ Start Joe out with $50 and start Bob out with $100. 

It’s up to you to figure out how to get Joe and Bob to start out with their Cash and 
Name fields set properly. Put it right underneath 工 nitializeComponent () in the form. 
That’s part of that designer-generated method that gets run once, when the form is first initialized. 
Once you’ve done that, click both buttons a number of times — make sure that one button takes 
$10 from the bank and adds it to Joe, and the other takes S5 from Bob and adds it to the bank. 



public Forml() { 

工 nitializeComponent(); -- ^ Add the lihes o-P dodc *fco 

// Initialize joe and bob here ! -the two objects srt 

thci\r 3hd Cash -fields. 
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exercise solution 


m 



jRciSe 

§PLjitJoH 


It’s up to you to figure out how to get Joe and Bob to start out with their Cash and 
Name fields set properly. Put it right underneath InitializeComponent()in the 
form. 


public Forml() { 

InitializeComponent(); 


— 代心七 u ? (\rsi 

o( ^v-s me 

的如如 objedt av^a v.c%i 

-tv/o sc-t *»*b (iclds. 


Make suve you dal I WpdatePovmO so 
the labels look vigh 七 -the -Pov-m 

-fivs-t pops up. 




bob = new Guy(); 
bob.Name = n Bob n 
bob.Cash = 100; 

joe = new Guy(); 
joe.Name = n Joe M 
joe.Cash = 50; 

UpdateForm(); 



The 的 y/e do -the same (or -the 

sedo^d 'ms-tahde o( -the 今 uy dlass. 


D 


therein 

)umb 


are no o 

Questi 9 ns 


^ Make swvc s ， vc 
V_ pyo\c6*t v/cll 

Utk W 七， “ 心 … W s . 


Why doesn’t the solution start with “Guy bob = new 
Guy ()"? Why did you leave off the first “Guy ”？ 

A! Because you already declared the bob field at the top of the 
form. Remember how the statement "int i = 5;” is the same 
as the two statements “inti” and “i = 5; ”? This is the same 
thing. You could try to declare the bob field in one line like this: 
"Guy bob = new Guy ();”■ But you already have the first 
part of that statement (“Guy bob;") at the top of your form. So 
you only need the second half of the line, the part that sets the bob 
field to create a new instance of Guy () ■ 


What happens if I don’t leave off that first “Guy ”？ What if 
it’s Guy bob = new Guy () instead of bob = new Guy () ? 

A! You’ll run into problems—your form won’t work, because it 
won’t ever set the form’s bob variable. If you have this code at the 
top of your form: 

public partial class Forml : Form { 
Guy bob; 

and then you have this code later on, inside a method: 


OK, so then why not get rid of the “Guy bobline at 
the top of the form? 

A. 

Then a variable called bob will only exist inside that special 
“public Forml () ” method. When you declare a variable 
inside a method, it’s only valid inside the method—you can’t access 
it from any other method. But when you declare it outside of your 
method but inside the form or a class that you added, then you’ve 
added a field accessible from any other method inside the form. 


Guy bob = new Guy(); 

then you’ve declared two variables. It’s a little confusing, because 
they both have the same name. But one of them is valid throughout 
the entire form, and the other one—the new one you added—is only 
valid inside the method. The next line (bob. Name = "Bob";) 
only updates that local variable, and doesn’t touch the one in the 
form. So when you try to run your code, it’ll give you a nasty error 
message ("NullReferenceException not handled”)，which just means 
you tried to use an object before you created it with new. 
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There's aw easier way to initialize objects 

Almost every object that you create needs to be initialized in some way. 

And the Guy object is no exception — it’s useless until you set its Name 
and Cash fields. It’s so common to have to initialize fields that G# gives 
you a shortcut for doing it called an object initializer. And the IDE’s 
IntelliSense will help you do it. 



Here’s the original code that you 
wrote to initialize Joe’s Guy object. 

joe = new Guy(); 
j oe.Name = n Joe"; 
joe.Cash = 50; 


Otject initializers 
save you time and 
make your cocte 
more compact 
and easier to 
reacL.anct tke 

IDE kelps you 

write tkem. 



Delete the second two lines and the semicolon after “Guy () ，，’ and add a right curly bracket. 

joe = new Guy() { 



Press space. As soon as you do, the IDE pops up an IntelliSense window that shows you all of 

the fields that you’re able to initialize. 

joe = new Guy() { 


Q 

Cash 

int Guy. Cash 

Q Name 




Press Tab to tell it to add the Cash field. Then set it equal to 50. 

joe = new Guy() { Cash = 50 



Type in a comma. As soon as you do, the other field shows up. 

joe = new Guy () { Cash = 50, 



Mame 


string Guy.Name 



Finish the object initializer. Now you’ve saved yourself two lines of code! 

joe = new Guy() { Cash = 50, Name = n Joe n }; 

TV>*is y>ev/ dcdlav-atior> docs c%at*tly same 
七 as "tKv-cc Irncs of todt you >wv~o*tc 
ov-'i^mally- I 七 ’s jus 七 sKovtcv- a^d casicv- b> v-cad- 



You used an object 
initializer in your 
“Save the Humans” 
game. Flip back and 
see if you can spot it! 
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a few helpful tips 


A few ideas for designing intuitive classes 


玲 You^e building your program to solve a problem. 

Spend some time thinking about that problem. Does it break down into pieces 
easily? How would you explain that problem to someone else? These are good 
things to think about when designing your classes. 

— ^ BB 純 6AT F 工 

f COUU> A FBWI 

l R^UTBS AND FI^URB OUT 

IS FASTBST— 

冷 What real-world things will your program use? 

A program to help a zookeeper track her animals’feeding schedules might have 
classes for different kinds of food and types of animals. 



ROAD CLOSED 
CHEMIN FERME 





Use descriptive names for classes and methods. 

Someone should be able to figure out what your classes and methods do just by 
looking at their names. 






Look for similarities between classes. 


Sometimes two classes can be combined into one if they're really similar. The candy 
manufacturing system might have three or four turbines, but there’s only one 
method for closing the trip valve that takes the turbine number as a parameter. 


Blocked Road i 

Name 

Duration 

ClosedRoad 

StreetName 

Reason ItsClosed 

FindDetour() 

CalculateDelay() 
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Detour 


Name 

Duration 

Reason ItsClosed 



FindDetour() 

CalculateDelay() 
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Add buttons to the Tun with Joe and Bob” program to make the guys give each other cash. 


KciSe 


O 


❺ 


USB AN OBJECT INITIAUZB12 TO INITIAUZB &OB f S 
INSTANCE OF 公 UY- 

You’ve already done it with Joe. Now make Bob’s instance work with an object 
initializer too. 

you already c\\ckt& -the button \us-t delete ii, add it badk -to you\r 
-Po\rm, irc^amc it Then delete the old kttod 一 CkkO method 
"the IDE sdded “sc the new wthod rt ddds now. 

At>t> 1VJO M^>12B BUTTONS TO Y£>U12 PO 訊 • 

The first button tells Joe to give 10 bucks to Bob, and the second tells Bob to give 5 
bucks back to Joe. Before you double-click on the button, go to the Properties 
window and change each button’s name using the “(Name)” row — it’s at the top of 
the list of properties. Name the first button j oeGivesToBob, and the second one 

bobGivesToJoe. 



qL ? Fun with Joe and Bob 



TK'lS -tells Joe *to 

a,vc 10 kutks *to Bob, so ” 
you should use i\\t w (Ka^c) 
vov/ m *tV^c 
Y/'mdov/ *bo i*t 
joc^WcsToBok. 


Joe has SS'D 
Ebb has S13C 
The bank has Si 3(3 



Give $1(] to 

Jbe 

Rec ei v e $5 
from Bob 

Joe gives SI Q 
^ to Bob 

Bob gives S5 
to Joe 參 





This bu-fc-fcoh -tdls Bob -to 
9 iv « 15 bu^ks h> Joe. 

|七 bobGivesToJoe. 


o 


MAKB THB BUTTONS VJ^IZK^ 

Double-click on the j oeGivesToBob button in the designer. The IDE will add a 
method to the form called j oeGivesToBob_Click () that gets run any time the 
button’s clicked. Fill in that method to make Joe give 10 bucks to Bob. Then double¬ 
click on the other button and fill in the new bobGivesToJoe—Click () method 
that the IDE creates so that Bob gives 5 bucks to Joe. Make sure the form updates itself 
after the cash changes hands. 


Here’s a tip for designing your forms. You can use these buttons on the IDE’s 
toolbar in the form designer to align controls, make them equal sizes, space 

them evenly, and bring them to the front or back. 


II 1l 1*1 X K M 
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exercise solution 



Add buttons to the “Fun with Joe and Bob” program to make the guys give each other cash. 


内 jRciSe 

§PLjitlOH 


public partial class Forml : Form 
Guy joe; 

Guy bob; 

int bank = 100; 

public Forml() { 

InitializeComponent(); 


a\rc the object L 

the two ihS-tahdcs of the ^uy dlass. 

Bob yts ihit.aliz.cd With loo budks 

his har^e. 


bob = new Guy() 

{ 

Cash = 

100 

,Name = 

"Bob' 

' }； 1 

joe = new Guy() 

{ 

Cash = 

50, 

Name =' 

'Joe" 

}； 



UpdateForm(); 


The U hcv-c is 


who’s the 
ddsh who^sj 

\rcdciv'm^ i*t- 


public void UpdateForm() 
j oesCashLabel.Text = 
bobsCashLabel.Text = 
bankCashLabel.Text = 


j oe.Name + " has 
bob.Name + " has 
"The bank has $，' 


$" + j oe.Cash; 
$" + bob.Cash; 
+ bank; 


private void buttonl—Click(object sender, EventArgs e) { 
if (bank >= 10) { 

bank -= j oe.ReceiveCash(10); 

UpdateForm(); 

} else { 

MessageBox. Show ("The bank is out of money .’，）； 


private void button2_Click(obj ect sender, EventArgs e) { 
bank += bob.GiveCash(5); 

UpdateForm(); 


To make Joe give dash 
"to Bob, wc 乙 dll Joe’s 
^ivcCashO ructhod 3hd 
schd its \rcsul-b ih-to 

Bob’s RcdcivcCasliO 
method. 


Lke a dlosc look at 
how the 与 uy methods 
bcihj tailed. The 
results \rctuv-hcd 
by ^ivcCashO a\rc 
pumped v-ight ih-fco 

Rc^civcCashO as its 



} pav-arwctcv-. 

private void joeGivesToBob 一 Click(object sender, EventArgs e) { 
bob.ReceiveCash(joe.GiveCash(10)); 

UpdateForm(); 

} 

private void bobGivesToJoe 一 Click(object sender, EventArgs e) { 
joe.ReceiveCash(bob.GiveCash(5)); 

UpdateForm(); 
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Before you go on, take a minute and flip to #2 in the “Leftovers” appendix, 
Chapter because there’s some basic syntax that we haven’t covered yet. You won’t 
need it to move forward, but it’s a good idea to see what’s there. 
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Objectcross 

It’s time to give your left brain a break, and put that 
right brain to work ： all the words are object-related 
and from this chapter. 



Across 

2. If a method’s return type is_ ， it doesn’t return anything 

7. An object’s fields define its_ 

9. A good method_makes it clear what the method 

does 

10. Where objects live 

11. What you use to build an object 

13. What you use to pass information into a method 

14. The statement you use to create an object 

15. Used to set an attribute on controls and other classes 


Down 

1. This form control lets the user choose a number from a range 
you set 

3. It’s a great idea to create a class_on paper before 

you start writing code 

4. An object uses this to keep track of what it knows 

5. These define what an object does 

6. An object’s methods define its_ 

7. Don’t use this keyword in your class declaration if you want to 
be able to create instances of it 

8. An object is an_of a class 

12. This statement tells a method to immediately exit, and can 
specify the value that should be passed back to the statement 
that called the method 
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puzzle solutions 



Paa] puzzjc §a]uflan 

Your job was to take code snippets from 
the pool and place them into the 
blank lines in the code. Your goal 
was to make classes that will 
compile and run and produce the 
output listed. 


public partial class Forml 
public Forml() { 

InitializeComponent(); 


Form 


private void buttonl_Click(object sender, EventArgs e) 
string result = 

Echo el = new Echo (); 

Bcho tL — 


int x = 0; 

while ( _ 

result — 


% 


<± 


){ 


result + el.Hello() 


\n' 


That’s the correct answer. 

And here’s the bonus answer! 
Bdho tl — cl ； 







MessageBox. Show (result + "Count : ，▼ + e2 . count) 


class 


public int 


Edho_ { 

dou 灼七 


0; 


public string 


MoO 


return "helloooo 
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Objectcross Solution 
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4 types and references 

it，s 獅 a ♦ 



Do you know where your data is? 





糊 [AN 11.1 】 

ImiiiirlillEiif 



參 


Data type, database, Lieutenant Commander Data... 

it’S all important stuff. Without data, your programs are useless. You 
need information from your users, and you use that to look up or produce new 
information to give back to them. In fact, almost everything you do in programming 
involves working with data in one way or another. In this chapter, you’ll learn the 
ins and outs of C#’s data types, see how to work with data in your program, and 
even figure out a few dirty secrets about objects (pssst … objects are data, too). 
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not my type 


The variable's typ^dctcrmiHGs what 
kmd of data itcaw store 

There are a bunch of types built into G#, and each one stores a 
different kind of data. You’ve already seen some of the most common 
ones, and you know how to use them. But there are a few that you 
haven’t seen, and they can really come in handy, too. 


All of the projects in this 
chapter are Windows Forms 
applications. If we tell you 
to create a new project 
in this chapter but don’t 
specify what type of project 
to create, assume it’s a 
Windows Forms Application 
created with Visual Studio 
for Windows Desktop. 


Types you’ll use all the time 

It shouldn’t come as a surprise that int, string, bool, and double are the most ^ v/V^ole y\uwbcv docs^ z 
common types. V^ave a dc“al ㈣ 七 . 

★ int can store any whole number from -2,147,483,648 to 2,147,483,647. 



string can hold text of any length (including the empty string n f, ). 

bool is a Boolean value — it’s either true or false. 

double can store real numbers from ±5.0 x 10 -324 to ±1.7 x 10 308 with up to 
16 significant figures. That range looks weird and complicated, but it’s actually 
pretty simple. The “significant figures” part means the precision of the number: 
35,048,410,000,000, 1,743,059, 14.43857, and 0.00004374155 all have seven 
significant figures. The 10 308 thing means that you can store any number as large 
as 10 308 (or 1 followed by 308 zeros) — as long as it only has 16 or fewer significant 
figures. On the other end of the range, 10— 324 means that you can store any number 



"Hiese hurhbe\rs 

乙 ailed 

poiivt **.3s opposed 
^ a u -pix C d poi^r 

仙州 ben v/kh alwa 

hur^b( 

decimal p|a^ cs> 


as small as 10 324 (or a decimal point followed by 324 zeros followed by 1).. .but, you 
guessed it, as long as it only has 16 or fewer significant figures. 


u n 


The u 
stands -Pov 

U j )) 

UhSijhCd- 


A lot of tiroes, i-f 
you Ye usmg these 

More types for whole numbers types i-t^s because 

Once upon a time, computer memory was really expensive, and processors were really Y ou solvmj a 
slow. And, believe it or not, if you used the wrong type, it could seriously slow down your y/hc\rc 

program. Luckily, times have changed, and most of the time if you need to store a whole 士 代 ally helps -fco 
number you can just use an int. But sometimes you really need something bigger.. .and 
once in a while, you need something smaller, too. That’s why G# gives you more options: aground 

you’ll \rcad dboui \ y \ 

★ byte can store any whole number between 0 and 255. 9 -few rwihu-tcs. 

★ sbyte can store any whole number from -128 to 127. 

★ short can store any whole number from -32,768 to 32,767 
夤 ushort can store any whole number from 0 to 65,535. 

夤 uint can store any whole number from 0 to 4,294,967,295. 



The V sby*tc stands -Pov- w si^cd, 
>whidh medr>s \i tBv\ be ( 七 he 

w si^ W is d mmus siyJ. 



long can store any whole number between minus and plus 9 billion billion, 
ulong can store any whole number between 0 and about 18 billion billion. 
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Types for storing really HUGE and really tiny numbers 

Sometimes seven significant figures just isn’t precise enough. And, believe it or not, sometimes 10 38 isn’t big^ ou ^ e 15 ^ !° 1C 
enough and 10 45 isn’t small enough. A lot of programs written for finance or scientific research run into 二齡 
these problems all the time, so G# gives us multiple types to handle floating-point values: . thaw 

Y ouyr )(fyA 1 L- 

y^ccdis ★ float can store any number from ±1.5 x 10 45 to ±3.4 x 10 38 with 7 significant digits. pvopcvtics use 

*to 心 al * double can store any number from ±5.0 x 10 324 to ±1.7 x 10 308 with 15-16 significant digits. values. 

7 0U 

usually wa 灼七 *bo > decimal can store any number from ±1.0 x 10 28 to ±7.9 x 10 28 with 28-29 significant digits. 

C__ A 'T.Wal W jwst mear,s a r.umbe'r ihat yoj* 

Literals have types，too ••二 ％ ” ，弓 ， s a Irteral. y。^ humcv-i^UpPowh 

When you type a number directly into your G# program, you’re using a literal. . .and you weve 

every literal is automatically assigned a type. You can see this for yourself~just enter this us,h 9 a decimal, 
line of code that assigns the literal 14.7 to an int variable: 


IVheh you used the 
l/aluc pvopcvty * 


int mylnt = 14.7; 

Now try to build the program. You’ll get this: 


Description 


1 Caninot implicitly convert type _decimal 1 to ■int 1 . An ecplidl conversiioirii 
exists [are you missing a cast?) 



l-r you iv-y -to assi^ a 
•float li-tcval -to a douk 


That’s the same error you’ll get if you try to set an int equal to a double variable. What 
the IDE is telling you is that the literal 14.7 has a type — it’s a double. You can change its" 
type to a float by sticking an F on the end (14.7F). And 14.7M is a decimal. 

The stands -fo\r w moir\cy W —sc\riously| li*tcv-al "to 3 double 

A few more useful built-in types a liteval to a 

Sometimes you need to store a single character like Qor 7 or $, and when you do you’ll 。此七心 IDE will jive 
use the char type. Literal values for char are always inside single quotes (▼ x ' ， ' 3 '). Y ou ^ help 七 “I messaje 

You can include escape sequences in the quotes, too (' \n ' is a line break, ' \ t' is v-cmmd'rnj you *to add 

a tab). You write an escape sequence in your G# code using two characters, but your su-f-rix. Cool/ 

program stores each escape sequence as a single character in memory. 


And finally, there’s one more important type: object. You’ve already seen how you 
can create objects by creating instances of classes. Well, every one of those objects can 
be assigned to an ob j ect variable. You’ll learn all about how objects and variables 
that refer to objects work later in this chapter. 


N d |o*t W\OY"C 
about how 乙 hdv ahd 
byte archie -to cac\) 

ih Chapter % 





The l^ir>dows CakulaW apj> has a ^ally called 

你 ode, whe\re you see bma\ry a^d dermal ai -the same 


You can use the Windows calculator to convert between decimal (normal, base-10) numbers and 
binary numbers (base-2 numbers written with only ones and zeros) — put it in Scientific mode, enter 
a number, and click the Bin radio button to convert to binary. Then click Dec to convert it back. Now 

enter some of the upper and lower limits for the whole number types (like -32,768 and 255) 
and convert them to binary. Can you figure out why C# gives you those particular limits? 


you are here ► 
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i’ll take an ice cream float to go 


A variable is like a data to - go cup |sfot all data tv\ds u\> oy\ *tKc V^ca\>. Value 

i W s usually k« ? ^c*.^ data m 

All of your data takes up space in memory. (Remember the heap part memory tailed *tVic s-tatk- Y ou '' 

from last chapter?) So part of your job is to think about how much |cav-v\ all about C^a^tcv* I 千 . 

space you’re going to need whenever you use a string or a number in 
your program. That’s one of the reasons you use variables. They let 
you set aside enough space in memory to store your data. 


Think of a variable like a cup that you keep your data in. C# uses 
a bunch of different kinds of cups to hold different kinds of data. 
And just like the different sizes of cups at the coffee shop, there are 
different sizes of variables, too. 


/° U；，/ / 0h g 

^ Who/c 



mi \s 60^0^7 vAScd (d'L 

A AortWUoW # 

*to 



byte holds humbevs 

bctwcch O av\d 1^. 


s_hort byte 

16 8 



TV^csc av-c 


如讀 ^ C oUrts d set as-.de U variable you deda 


Numbers that have decimal places are stored differently than 
whole numbers. You can handle most of your numbers that have 
decimal places using float, the smallest data type that stores 
decimals. If you need to be more precise, use a double. And 
if you’re writing a financial application where you’ll be storing 
currency values, you’ll want to use the decimal type. 

It’s not always about numbers, though. (You wouldn’t expect to 
get hot coffee in a plastic cup or cold coffee in a paper one.) The 
C# compiler also can handle characters and non-numeric types. 
The char type holds one character, and string is used for lots 
of characters “strung” together. There’s no set size for a string 
object, either. It expands to hold as much data as you need to store 
in it. The bool data type is used to store true or false values, like 
the ones you’ve used for your if statements. 



float double decimal 

32 64 128 



TV>csc ^ 

sto 1 


>vc wove 



bool 

8 


char string 

16 depends on 
the size 
of the string 
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10 pounds of data m a 5-pouwd bag 



When you declare your variable as one type, that’s how your 
compiler looks at it. Even if the value is nowhere near the upper 
boundary of the type you’ve declared, the compiler will see the cup 
it’s in, not the number inside. So this won’t work: 


int leaguesUnderTheSea 


20000 


short smallerLeagues = leaguesUnderTheSea; 

20,000 would fit into a short, no problem. But since 
leaguesUnderTheSea is declared as an int, the compiler sees 
it as int-sized and considers it too big to put in a short container. 
The compiler won’t make those translations for you on the fly. You 
need to make sure that you’re using the right type for the data 
you’re working with. 


20,000 


c^terpen your pencil 


f[\\ -tKc tomp'ilcv- sees »s an 

•m 七 ^0^5 m*to a short (广 

doesn't y/ovk). I*t docsy\ "b tdii't 
dbou*b value 



S ^： 


Itis 

，S ^-9 io C 6 °^ 1 


you. 


Three of these statements won’t compile, either because they’re 
trying to cram too much data into a small variable or because 
they’re putting the wrong type of data in. Circle them. 


int hours 


24 


short y 


78000 


string taunt 


byte days = 365 


your mother"; 


bool isDone 


yes 


long radius = 3; 


short RPM 


33 


char initial 


'S 


int balance 


345667 - 567 


string months 


12 


you are here ► 
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casting call 


Evgw when a number is the right size, 
you caw't just assign it to awy variable 

Let’s see what happens when you try to assign 
a decimal value to an int variable. 


❶ 


Create a new Windows Forms project and add a button to it. Then add 
these lines to the button’s Click () method: 

decimal myDecimalValue = 10; 
int mylntValue = myDecimalValue; 



MessageBox.Show("The mylntValue is 


mylntValue); 


❺ Try building your program. Uh oh — you got an error that looks like this: 



❺ 


Make the error go away by casting the decimal to an int. Once you change 
the second line so it looks like this, your program will compile and run: 


ou*b 

i\^t IPE- 

out you 
y/cv-c fv-obably 
rn'iss'm^ d ddst 


int mylntValue 


So what happened? 


(int) myDecimalValue; 

you das-b Bic 
缸 i 眯 al value -to av\ m 七 . 


The compiler won’t let you assign a value to a variable if it’s the wrong type — even if that variable 
can hold the value just fine — because that’s the underlying cause behind an enormous number of 
bugs, and the compiler is helping by nudging you in the right direction. When you use casting, 
you’re essentially making a promise to the compiler that you know the types are different, and that 
in this particular instance it’s OK for G# to cram the data into the new variable. 


c^terpen your pencil 


a -to -flip 

k ^ ihc 

or the las-t <ihap-tc\r ahd 
oui how you used 
wheh y ou passed 

\ the 乙 KpD OWh . 

VaU h> the Talk 饮 




Three of these statements won’t compile, either because they’re 
trying to cram too much data into a small variable or because 
they’re putting the wrong type of data in. Circle them. 


TWis 卿 bev s W W 


^byte 


days — 365 



bool isDone 


yes; y olA ^ oy ^|y assi^ 

- ov- U -Valsc w *to 


a value 

d bool- 


A byte car\ ov\\y hold a 
value O artdi 

Y^ull v\Ctd d shoirt -Pov -this. 


You can read more about the value types in C# here: 
http://msdn.microsoft.com/en-us 川 brarv/s1ax56ch.asijx 
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Whew you casta value that's too 
big, C # will adjust it automatically 


You’ve already seen that a decimal can be cast to an 
int. It turns out that any number can be cast to any other 
number. But that doesn’t mean the value stays intact 
through the casting. If you cast an int variable that’s set 
to 365 to a byte variable, 365 is too big for the byte. But 
instead of giving you an error, the value will just wrap 
around: for example, 256 cast to a byte will have a value 
of 0. 257 would be converted to 1, 258 to 2, etc., up to 365, 
which will end up being 109. And once you get back to 
255 again, the conversion value “wraps” back to zero. 


H yo^self/ 

Thetre s ho n,ysie\ry how '> * 

the humbcirs—you Wo i 3 

p” & 

to swi^h ii 

Li bu ^ ^ doesa 

modu, ° y oul , l01 docs 5 


c^Jharpen your pencil 

You can’t always c< 



鶴 


^4 


WBY, IV6 B66NJ 

NJUMB612S AMD 
STISINJ^S IM MY M6SSA^6 
BOXES SINCE X UBA12NJ6D 
ABOUT UOOPS IM ^HAPTBIS 
Zi WAN/S 工 BBBN CONVBT^TIN^ 
TYPES ALL AU>N6r? 


I/Vheh you’ve 
dssi^hih^ d humbcv* 
value -to a -float, 
you heed -to add 
F -to the chd 
°*f the humbev* *to 
"tell the ^orvtpilcv* 
that it s a -float, 
3hd hot a double. 

othcirwisc, -the 

匕 ode woh'-t Compile. 


Yes! The + operator converts for 
you. 

What you’ve been doing is using the + 
operator, which does a lot of converting 
for you automatically — but it’s especially 
smart about it. When you use + to add a 
number or Boolean to a string, then it’ll 
automatically convert that value to a string, 
too. If you use + (or *，/, or -) with two 
different types, it automatically converts 
the smaller type to the bigger one. 
Here’s an example: 

int mylnt = 3 ^: _ 

^ - - - ^ 

一 float myFloat = 16.4F; 

myFloat = mylnt + myFloat; 

Since an int can fit into a float but a 
float can’t fit into an int, the + operator 
converts mylnt to a float before adding it 
to myFloat. 


r t always cast any type to any 
other type. Create a new project, drag a 
button onto a form, double-click on it, and type 
these statements in. Then build your program — it 
will give lots of errors. Cross out the ones that 
give errors. That’ll help you figure out which 
types can be cast, and which can’t! 


int mylnt 


10 


byte myByte = (byte)mylnt; 
double myDouble = (double)myByte; 
bool myBool = (bool)myDouble; 


string myString 


false 


myBool = 
myString 


(bool)myString; 

=(string)mylnt; 


myString = mylnt.ToString(); 
myBool = (bool)myByte; 
myByte = (byte)myBool; 
short myShort = (short)mylnt; 


char myChar 
myString = 


x 


string)myChar; 


long myLong = (long)mylnt; 

decimal myDecimal = (decimal)myLong; 

myString = myString + mylnt + myByte 
+ myDouble + myChar; 


you are here ► 
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a true convert 


C # does some casting automatically 

There are two important conversions that don’t require 
you to do the casting. The first is done automatically any 
time you use arithmetic operators, like in this example: 


long 


139401930 


short s = 516; 


double d 



Tiic - opcvatov- 
sub*tv-at*tcd sKovt 
•^•Vom "tKc lor>^ 

— opcva*tov- £.or\vcv-*tcd 
*tKc wul 七 *to a double- 


d 


d / 123.456; 


MessageBox.Show("The answer is " ( + d); 

W\)cv\ you use + ii's smav-t chough J 
■to Covwevi 七 he decimal b> a 


your pencil_ 

Solution 

You can’t always cast any type to any other 
type. Create a new project, drag a button onto a 
form, and type these statements into its method. 
Then build your program — it will give lots of 
errors. Cross out the ones that give errors. That'll 
help you figure out which types can be cast, and 
which can’t! 


c^^rpen 


The other way G# converts types for you automatically is when 
you use the + operator to concatenate strings (which just 
means sticking one string on the end of another, like you’ve been 
doing with message boxes). When you use + to concatenate 
a string with something that’s another type, it automatically 
converts the numbers to strings for you. Here’s an example. The 
first two lines are fine, but the third one won’t compile. 

long x = 139401930; 

MessageBox.Show("The answer is " + x); 

MessageBox.Show(x); 

The G# compiler spits out an error that mentions something 
about invalid arguments (an argument is what G# calls the 
value that you’re passing into a method’s parameter). That’s 
because the parameter for MessageBox . Show () is a 
string, and this code passed a long, which is the wrong 
type for the method. But you can convert it to a string really 
easily by calling its ToString () method. That method is a 
member of every value type and object. (All of the classes you 
build yourself have a ToString () method that returns the 
class name.) That’s how you can convert x to something that 
MessageBox . Show () can use: 

MessageBox.Show(x.ToString ()); 


int mylnt = 10; 

byte myByte = (byte)mylnt; 

double myDouble = (double)myByte; 

string myString = "false"; 

^-otrin-g) myPrrfc ; 、 

myString = mylnt•ToString (); 

-•m.yRooJ — ~ ( - b^) o 1) myB y t -Q -; 

一 — (by Lc) myDoul ;■ - 

short myShort = (short)mylnt; 

char myChar = 'x'; 

-m yString — — (3 Li 丄 n g ) Chai-'; 

long myLong = (long)mylnt; 

decimal myDecimal = (decimal)myLong; 

myString = myString + mylnt + myByte 
+ myDouble + myChar; 
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Whew you call a method, the arguments must 
be compatible with the types of the parameters h t f 


Try calling MessageBox . Show ( 123 ) — passing MessageBox . Show () 
a literal (123) instead of a string. The IDE won’t let you build your program. 
Instead, it’ll show you an error in the IDE: “Argument c l 5 : cannot convert from 
i int , to ‘string’.’’ Sometimes G# can do the conversion automatically — like if 
your method expects an int, but you pass it a short — but it can’t do that for 
ints and strings. 

But MessageBox . Show () isn’t the only method that will give you compiler 
errors if you try to pass it a variable whose type doesn’t match the parameter. 
All methods will do that, even the ones you write yourself. Go ahead and try 
typing this completely valid method into a class: 

public int MyMethod(bool yesNo) 


types and references 

A fav-ametev- is what you 
dc+ihC \y\ you\r method. /U 
is what you pass 

^_"fco i-fc. 

dah take a byte 


if (yesNo) { 
return 45 
} else { 

return 61 

} 




av-gurnCht. 

Wken tke 
compiler gives 
you an ff invalid 
arguments” error, 
it means tkat 
you tried to 
call a metkoct 


a w“a\\ed i 十 witk variables 

wkose types 
ctictn’t matcli 
tke metkocTs 
parameters. 


!SS£ 5 ^' s 


It works just fine if you pass it what it expects (a bool) — call MyMethod (true) or 
MyMethod (false), and it compiles just fine. 

But what happens if you pass it an integer or a string instead? The IDE gives you a 
similar error to the one that you got when you passed 123 to MessageBox . Show () 
Now try passing it a Boolean, but assigning the return value to a string or passing it on 
to MessageBox . Show () . That won’t work, either — the method returns an int, not 
a long or the string that MessageBox . Show () expects. 



Y°^ 乙 assi^h 

-to a vaHable ； 
oy -field 

With the type objed-t. 


广 / 
You did *tlVis 
\y\ the CoAt 
you 

\y\ w Savc 

一 Jo 

ba^k ar\d 
have a look; 
sec i-f you 

匕扣 spot i*t- 


4 alv/ays test ^ see ^ so^ctW.^s Vuc 

⑽产⑽恤 一桃御 lestaWd 1.^ tW,s ： 

^ — No) ( « f -- -tv-ue) M nats betausc a« statement al^ 

lA/c did^t Kavc c^liditlv say 7 ^ ( ^ 七一 — 七 ，饮七 V>e 

^Cdks ^ Vou ^ some 口 Y ( N 上二版 )' | 於 ou 以 。 de …—以 

NOTraW.Y (〜,。) is t e same w .d N r （ ㈣。)' andUot 叫 1 碼 

W ^o„ V o^Usuallv>stsee us do ^ (yesNo ； ，Y 

cMtck bo sec ^ a Boolean is true or +aUc. 


you are here ► 
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this table is reserved 



«ciSe 


^ y° u -to use \rcsc\rvcd keywov-ds as v^Hable ^cs, 

you put @ *m -f\roht c^f i*t, but that's as dose as the 
J will Ic-t you jet -to -the \rcsc\rvcd keywov-d- You do 

匕 that with ho^\rcsc\rvcd v\^e^ -l-on. S u 〜 k 


ho^\rcsc\rvcd K>amcs -fcoo, i-p you Wolht to. 

There are about 77 reserved words called keywords in C#. These are words reserved by the C# 
compiler; you can’t use them for variable names. You'll know a lot of them really well by the time you 
finish the book. Here are some you’ve already used. Write down what you think these words do in C#. 


namespace 


for 


class 


public 


else 


new 


using 


while 
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Create a reimbursement calculator for a business trip. It should allow the user to enter a starting 
and ending mileage reading from the car’s odometer. From those two numbers, it will calculate 
how many miles she’s traveled and figure out how much she should be reimbursed if her 
company pays her $.39 for every mile she puts on her car. 


o 


START UJITHA N5UJ \^lNt>OVJS F^>12MS PIZ^JBCT^ 

Make the form look like this: - - 一 

of 




Mileage Calculator 



This label is IZ 
P"t bold. ^ 


Starting Mileage 
&iirig Mileage 


Amount Owed labeI4 


Calculate 


"the 

bu-fc-tohs. 



the two N^\cU ? Vo^ 


When you’re done with the form, double-click on the 
button to add some code to the project. 

❺ CIZBATB THB FIBUt>S YOU f UU NBBt> F^>12 TH5 CAUCUUATO^ 

Put the fields in the class definition at the top of Forml. You need two whole number 
values to track the starting odometer reading and the ending odometer reading. Gall them 
startingMileage and endingMileage. You need three numbers that can hold decimal 
places. Make them doubles and call them milesTraveled, reimburseRate, and 
amountOwed. Set the value for reimburseRate to .39. 


❺ MAKS YOUJZ CAUCUUATOIZ 

Add code in the buttonl 一 Click () method to: 

* Make sure that the number in the startingMileage field is smaller than the 
number in the endingMileage field. If not, show a message box that says “The 
starting mileage must be less than the ending mileage.” Make the title for the 
message box “Cannot Calculate Mileage.” 

★ Subtract the starting number from the ending number and then multiply it by the 
reimburse rate using these lines: 

milesTraveled = endingMileage -= startingMileage; 
amountOwed = milesTraveled *= reimburseRate; 


label4. Text = + amountOwed; 

❹ ISUN IT- 

Make sure it’s giving the right numbers. Try changing the starting value to be higher than 
the ending value, and make sure it’s giving you the message box. 


you are here ► 
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something^ wrong... 


ExCIRciSd 


内 jRciSe 

§PLjitlOH 


You were asked to create a reimbursement calculator for a business trip. Here’s the code for the 
first part of the exercise. 


public partial class Forml : Form 


int startingMileage 
int endingMileage; 


double milesTraveled 


double reimburseRate 


double amountOwed, 



.39 


t wo^rks yr Ca i “士 

This dould 

3® all -the way up -to 

goa n byte 

匕 U"t it 


public Forml() { 

InitializeComponent(); 

} 


pd ， v-ewewbev- 
^ o\a V>avc *to 
tast tV>c dermal 
value ^vow 

private void buttonl_Click (object sender, EventArgs e) { …鄉 

startingMileage = (int) numericUpDownl .Value ; 亡 - - - to 灼 * brol 。 扣 …七 


endingMileage = (int)numericUpDown2.Value; 
if (startingMileage < endingMileage){ 

milesTraveled = endingMileage -= startingMileage; 
amountOwed = milesTraveled *= reimburseRate 
label4. Text = ’▼$’▼ + amountOwed; 

} else { 



丁 his blodk is 
supposed -to -figuv-c 
out how \mSy\y 
以 1« weve tv-avclcd 
"thch multiply 
them by -the 
\rcirnbu\rscmch-t V-atc. 


MessageBox.Show( 

The starting mileage must be less than the ending mileage", 

"Cannot Calculate Mileage"); 

M used sy \ altcv-hatc 


This button seems to work, but it has a 
pretty big problem. Can you spot it? 


dixc\rhatc way 
the /WcssagcBox. 
ShowO method hcv-c. Wc 0ave 

rt two pa\ramc-tc\rs ： -fchc -fiv-st 
ohc is -the message -to display, 
3hd the sedohd OhC aoes ih 
the title bav-. 
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Pebug the mileage calculator 

There’s something wrong with the mileage calculator. Whenever your code doesn’t work 
the way you expect it to, there’s always a reason for it, and your job is to figure out what 
that reason is. Let’s figure out what went wrong here and see if we can fix it. 

❶ At>t> AN^THBIZ BOTTOM TO THB POJH 

Let’s track down that problem by adding a button to your form that shows the value 
of the milesTraveled field. (You could also use the debugger for this!) 

Clidkihg this but-fcoh 
youW disked Calculate should 
show "tKc hunrtbev* o-p rhij(s 
tv-avclcd ih a box. 


When you’re done with the form, double-click on the 
Display Miles button to add some code to the project. 

❺ ONB UbiB SH^>UUt> 00 IT- 

All we need to do is get the form to display the milesTraveled variable, right? So this line 
should do that: 

private void button2_Click(object sender, EventArgs e) { 

MessageBox.Show(milesTraveled + " miles", "Miles Traveled"); 


(D eUN IT- 

Type in some values and see what happens. First enter a starting mileage and 
ending mileage, and click the Calculate button. Then click the Display Miles 
button to see what’s stored in the milesTraveled field. 


Miles Traveled 


532.35 miles 


OK 


O UM, S^MBTHIN^S NOT Bl 彡 HT .〜 

No matter what numbers you use, the number of miles always matches the amount owed. Why? 



口 iJ 


Mileage Calculator 


Starting Mileage 
Ending Mileage 


ia™ 


: 


12345 


: 


Amount Owed $532.35 


Calculate 


Display Miles 
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operators are standing by 

Combining ^ with aw operator 

Take a good look at the operator we used to subtract ending mileage from 
starting mileage (- =). The problem is it doesn’t just subtract, it also assigns a 
value to the variable on the left side of the subtraction sign. The same thing 
happens in the line where we multiply the number of miles traveled by the 
reimbursement rate. We should replace the -= and the *= with just - and *: 


private void buttonl Click(object sender, EventArgs e) 


startingMileage = (int) numericUpDownl.Value; 
endingMileage = (int)numericUpDown2.Value; 
if (startingMileage < endingMileage){ 

milesTraveled = endingMileage tartingMileage 

amountOwed = milesTraveled c：= reimburseRate; 


label4.Text 


$ 


amountOwed 


T\\m av-c 
tailed 

ofcva*tov-s. 
ov\C sulo'tv' 
s*bav 七〜 M “ cay 

W 七 also assies 
value 

w'llcsTva^clcd 
i\\t sa^c Wc- 


t 


else { 

MessageBox.Show("The starting mileage number must 

be less than the e^iing mileage number ", 
Cannot Calculate J^leage"); 


TWis \s 

youv todt 七 
w\lcsT\ravclcd. 



milesTraveled = endingMileage - startingMileage 
amountOwed = milesTraveled * reimburseRate : 


So can good variable names help you out here? Definitely! Take a 
close look at what each variable is supposed to do. You already get a lot of 
clues from the name milesTraveled — you know that’s the variable that 
the form is displaying incorrectly, and you’ve got a good idea of how that 
value ought to be calculated. So you can take advantage of that when you’re 
looking through your code to try to track down the bug. It’d be a whole lot 
harder to find the problem if the incorrect lines looked like this instead: 

mT = eM - 

aO = mT * 



1/airiJb/es ^ ed I，,. 


154 Chapter 4 






types and references 


Objects use variables, too 

So far, we’ve looked at objects separate from other types. But 
an object is just another data type. Your code treats objects 
exactly like it treats numbers, strings, and Booleans. It uses 
variables to work with them: 


① 


Using an int 

Write a statement to declare the integer. 

int mylnt; 




Assign a value to the new variable. 

mylnt = 3761; 


o 

o 


Using aw object 


Write a statement to declare the object. 

Dog spot; 7 ⑽ have a 

like P05, 7^ uSC 

i\\t m a 命 ’ aWc 

dc6lavat»ov\ 

Assign a value to the object. 

spot = new Dog(); 



⑧ 


Use the integer in your code. 


o 


Check one of the object’s fields. 


while (i < mylnt) 


while (spot.IsHappy) { 


o 


O 


SO IT D^BSM^ MATTBR IF UtA 
W^RICIN^ WITH AM OR A MUMBRI6 

VAUU6- IF ITS \mO MEMORY ； AMD MY 

PR^^RAM M5BDS TO US5 IT , 工 USB A VARIABLE. 



Objects are just one more type of 
variable your program can use. 

If your program needs to work with a whole 
number that’s really big, use a long. If it needs 
a whole number that’s small, use a short. If it 
needs a yes/no value, use a boolean. And if it 
needs something that barks and sits, use a Dog. No 
matter what type of data your program needs to 
work with, it’ll use a variable. 


you are here ► 
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get the reference 


Refer to your objects with reference variables 

When you create a new object, you use code like new Guy (). But that’s not enough; 
even though that code creates a new Guy object on the heap, it doesn’t give you 
a way to access that object. You need a reference to the object. So you create 
a reference variable: a variable of type Guy with a name, like joe. So joe 
is a reference to the new Guy object you created. Any time you want to use that 
particular guy, you can reference it with the reference variable called joe. 

So when you have a variable that is an object type, it’s a reference variable: a 
reference to a particular object. Take a look: 


That’s tailed 
•mstaAa 七， M 



rteves ^ ca ? behove 70UV 


TWis vav'«ablc public partial class Forml : 

is v\3wcd ( 


j oC i 


a 灼 


teWc 7 

dV\ object y/ 

七 Yj>c 爲呼 


Guy joe; 

public Forml() 

{ 

InitializeComponent(); 



Form 


joe 




new Guy(); 



Cvcatm^ a vc*fcv-cir>dc is like a label 
a label makcv—*ms*tcad o( stidkm^ *i*t 
oy\ youv* youVc us'm^ i*t *to label 扣 

objcd*t so you Uv\ vc-fcv- {0 *rt la 七 d 


TW»s is … 3hd this is the 

vahaWe... 七杜 七 that joe 

^OW \rc-Pcv-s {jo. 


tteve’s 七 he hca? 
objedi ttc vanaWe 

Joe ^ 





% ob\^ 


^ 〜、丁 4 way -to 

-this ^ obj^i 

，S 仏 ' o— WC\TChdC 

㈣ blc called joc. 
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types and references 


References are like labels for your object 


In your kitchen, you probably have containers of salt and sugar. If you 
switched their labels, it would make for a pretty disgusting meal- 


even 


though the labels changed, the contents of the containers stayed the same. 
References are like labels. You can move labels around and point them at 
different things, but it’s the object that dictates what methods and data are 
available, not the reference itself. 


TKis object is Jc type 
It’s a SINGLE object Vrtii 
MULTIPLE- vc-fcv-cr>dcs. 


FWs bu^/ Chtk A 


Guy dad 



Ah o-f -fcKc 今 uy 

dass is keeping a \rc-fcv-chdc 
"to "this objed-fc ih d variable 

called Dad. 


Evc^y o hC of these labels 

variable but they all 
poiht {o the SA/WE t 
object. 


You never refer to your object directly. For example, you can’t write code like 
Guy. GiveCash () if Guy is your object type. The G# compiler doesn’t 
know which Guy you’re talking about, since you might have several instances 
of Guy on the heap. So you need a reference variable, like joe, that you 
assign to a specific instance, like Guy j oe = new Guy (). 



Wken your code 
needs to work 
witk an otject 
in memory, it 
uses a reierence ， 
wliicli is a 
variable wkose 
type is a class 
ol tke object it’s 
going to point to. 
A reierence is 
like a latel tkat 
your cocte uses 
to talk aLout a 
specific otject. 


Now you can call (non-static) methods like joe . GiveCash (). joe refers 
to a specific instance of the Guy class, and your G# compiler knows exactly 
which instance to use. And, as you saw above, you might have multiple 
labels pointing to the same instance. So you could say Guy dad = 
joe, and then call dad. GiveCash (). That’s OK, too — that’s what Joe’s 
kid does even 


^ lots o( d\^i 

1 1 °\°^ ⑽七 methods use 
^ thihas. Bach 

has a did “一 
that schse m its 
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that’s sanitation engineer, thank you very much 


If there aren't awy more references, 
your object gets garbage - collected 

If all of the labels come off of an object, programs can no longer 
access that object. That means G# can mark the object for garbage 
collection. That’s when C# gets rid of any unreferenced objects, and 
reclaims the memory those objects took up for your program’s use. 

o Here's some code that creates an object. 


Guy joe = new Guy() 

{ Name = "Joe ", Cash 


50 


you use statement 

youVc tcllrnj C# ⑽ ate a” o\>\td 

]/^tY\ you iake a variable 

like Joe ar\d ass'i^ i*t *to object 
*，Vs like youVc slapfa label 
oy \ i*t- 



% ob〆 


For an object 
to stay in tke 
keap, it lias to 
te relerencect. 
Some time 
alter tke last 
reference to 
tke otject 
disappears, so 
does tke object. 


❺ Now lets create a second object. 


Guy bob 
{ Name 


new Guy() 
"Bob", Cash 


75 


^ WC have i Wo 


% 七必 t 

3 




^ % Ob^ % Ob〆 


o Let’s take the reference to the first object, and 
change it to point at the second object. 




joe = bob; 


Kow joc is poih-tihj -to the same 
object 3s bob. 



S(/ y ob]^ 



lo^cv- 

a "to 

^ivst ^ 士 〆… 


poof ! 卜 


...SO C# m\^\rks the 

oi>\cd (o>r garbage 
^ollc^-tioh, 3 hd 

广， iu 今 toshes ii 

Its gohe/ 
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Typecross 

Take a break, sit back, and give 
your right brain something 
to do. It’s your standard 
crossword; all of the solution 
words are from this chapter. 

When you’re done, turn the 
page and take on the rest 
of the chapter. 



Across 

1. The second part of a variable declaration 

4. namespace, for, while, using, and new are 

examples of_words 

6. What (int) is doing in this line of code: x = (int) y; 

8. When an object no longer has any references pointing to it, 
it’s removed from the heap using_collection 

10. What you’re doing when you use the + operator to stick two 
strings together 

14. The numeric type that holds the biggest numbers 

15. The type that stores a single letter or number 

16. \n and \r are_sequences 

17. The four whole-number types that only hold positive 
numbers 


Down 

2. You can combine the variable declaration and the_ 

into one statement 

3. A variable that points to an object 

5. What your program uses to work with data that’s in memory 
7. If you want to store a currency value, use this type 
9. += and -= are this kind of operator 

11. A variable declaration always starts with this 

12. Every object has this method that converts it to a string 

13. When you’ve got a variable of this type, you can assign any 
value to it 

- ► Aiders on page 183. 
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so many labels 


Multiple references and their side effects 


You’ve got to be careful when you start moving around reference 
variables. Lots of times, it might seem like you’re simply pointing 
a variable to a different object. But you could end up removing all 
references to another object in the process. That’s not a bad thing, but 
it may not be what you intended. Take a look: 


Dog rover = 

new Dog(); 

rover.Breed 

="Greyhound"; 

Objects: 


References: 




Rovcv- is d Doj object B 
Bvccd -field sc*t *bo ^rcyhou 灼 d. 


❺ Dog fido = new Dog(); 
fido.Breed = "Beagle"; 
Dog spot = rover; 


9 

Objects:__ 
References: 



Fido is a^o*tiiC\r Doj object 
Bu 七 Spot is jus 七 a^o*thcv- 

*bo -fivs*t object 


❺ Dog lucky = new Dog(); 

lucky.Breed = "Dachshund' 


fido 


rover; 


Objects: 


z 


References: 


•午 


Ludky is a olojedt 
Bu 七 Fido is r\ov/ 

*to object - So, Objcd*t 
#Z has y\o \rc*fcv*c 灼 dcs. 

It’s doY\t as -far as -the 
is 





poof 卜 




\ ob*^ 
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types and references 


c^^rpen your pencil 


Now it’s your turn. Here’s one long block of code. Figure out how many 
objects and references there are at each stage. On the righthand side, 
draw a picture of the objects and labels in the heap. 



Dog rover = new Dog(); 
rover.Breed = "Greyhound"; 
Dog rinTinTin = new Dog(); 
Dog fido = new Dog (); 

Dog quentin = fido; 


Objects: 


References: 


❻ Dog spot = new Dog(); 

spot.Breed = "Dachshund"; 
spot = rover; 

Objects:_ 

References:_ 



Dog lucky = new Dog(); 
lucky.Breed = "Beagle"; 
Dog charlie = fido; 
fido = rover; 


Objects: 


References: 



rinTinTin = lucky; 

Dog laverne = new Dog(); 
laverne.Breed = "pug"; 


Objects: 


References: 


❺ charlie = laverne; 
lucky = rinTinTin; 


Objects: 


References: 
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swapping elephants 




O^f 




°Q 


c^^rpen your pencil 


Now it’s your turn. Here’s one long block of code. Figure out how many 
objects and references there are at each stage. On the righthand side, 
draw a picture of the objects and labels in the heap. 


Dog rover = new Dog(); 
rover.Breed = "Greyhound"; 
Dog rinTinTin = new Dog (); 
Dog fido = new Dog(); 

Dog quentin = fido; 


Objects: 


References: 


Dog spot = new Dog() 
spot.Breed = "Dachshund 
spot = rover; 


Ot\t new Doj object is 

bu*t Spo-t is -the 
OY\ ly v-c-Pcv-c^dc -to it 

J Spo-t is sc-t -to Rovcv, -thai 
ob\cd*t ( 


objed-t joes awdy. 


Objects: 


References: 


Hcvc 3 P 05 ob\cC.*t >s 

twted, lou 七 v/^cwlFido >s 
stibo Rovc^r, Fid。、okjett 

f <(V。 州 #1 ^OCS a 叫 . 


Dog lucky = new Dog(); 

lucky. Breed = "Beagle" ;C^av-lic vjBs sc*t *b> F»do 
Dog charlie = fido; v/iicr\ Fido y/ 3 s still ov\ 

fido = rover; 


Objects: 


^ object 料 T\\tY\, a-H 
^~* Fido moved *to v 

养 I, ledv'm^ C^av"lic bciimd 


References: 


P 05 los*t i"ts 
las*t by\A 、— 

i 七 v/c 灼七 away. 


rinTinTin = lucky; 

Dog laverne = new Dog() 
laverne.Breed = "pug"; 

午 — 

W\\tY\ R'm T'm T*m 

moved *to Ludky’s 
object "the old R*m Tm 

Tm object disappeared. 


Objects: 


References: 




charlie = laverne; 
lucky = rinTinTin; 

^ He VC "the V"C-PcV"CK>dCS move 
N^av-ou^d, bu-t y\o hc>w objects 

S av-c treated. A^d settmg 
Ludky -to R"m T"m Tm did 
hoth'mj because -they already 

pomied {jo the same object 


Objects: 


References: 


°9 do 
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types and references 




Create a program with an Elephant class. Make two Elephant instances and 
then swap the reference values that point to them, without any Elephant 
instances garbage-collected. 


o 




Start with a new Windows Forms Application project. 

Make the form look like this: . — ^ccd io 


㈡ 你 

^l^ss 



出 s? lav tW、s 


bo^- 


Lucinda says". 



^ Create the Elephant class. 


My ears are 33 inches tall. 


□ K 



TV^c ^\\oM0 mc*t^od should 
up message bo%. Make sun 
message mtludcs cav* siz^ 
*t*i*tlc kav- mdudes i\\t Mme. 


and 


Add an Elephant class to the project. Have a look at the Elephant class diagram — you’ll need an int 
field called Ear Size and a String field called Name. (Make sure both are public.) Then add a method 
called WhoAmI () that displays a message box that tells you the name and ear size of the elephant. 

o Create two Elephant instances and a reference. 

Add two Elephant fields to the Forml class (in the area right below the class declaration) named 
Lloyd and Lucinda. Initialize them so they have the right name and ear size. Here are the 
Elephant object initializers to add to your form: 


lucinda = new Elephant() { Name 

lloyd = new Elephant() { Name = 


: "Lucinda ", EarSize = 33 
Lloyd ", EarSize =40 }; 


o 

o 


Make the Lloyd and Lucinda buttons work. 

Have the Lloyd button call lloyd. WhoAm 工 （）and the Lucinda button call lucinda . WhoAmI ()• 


Hook up the swap button. 

Here’s the hard part. Make the Swap button exchange the two references, so that when you click 
Swap, the Lloyd and Lucinda variables swap objects and a “Objects swapped” box is displayed. 
Test out your program by clicking the Swap button and then clicking the other two buttons. The first 
time you click Swap, the Lloyd button should pop up Lucinda’s message box, and the Lucinda button 
should pop up Lloyd’s message box. If you click the Swap button again, everything should go back. 


C# garbage-collects any object with no references to it. So here’s your 
hint: If you want to pour a glass of beer into another glass that’s currently 
full of water ， you’ll need a third glass to pour the water into.... 
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hold that reference 



§ 0 (.ytiPH 


using System.Windows.Forms; 
class Elephant { 


Create a program with an Elephant class. Make two Elephant instances and 
then swap the reference values that point to them, without getting any Elephant 
instances garbage-collected. / - 

^ TW»s \s 

tlass todt 


public int EarSize; 
public string Name; 


public void WhoAm 工 （）{ 

MessageBox.Show("My ears are 
Name + " says..."); 

} 


You can put the using statements inside 
the namespace curly brackets if you want. 


EarSize 


inches tall 


…仏 c ei—a 中 s 

心 w added 

如 vm s 7 st r ； 

at *to? ^ 
tlass. lA/'^out »*t) 
Message% slat — 七 

如 OV>’t N^OV-k. 


fire s 仏 e PornrJ 
•hrom Fo\rnxl.Cs. 


public partial class Forml : Form 

Elephant lucinda; 

Elephant lloyd; 

public Forml() 

{ 

工 nitializeComponent(); 
lucinda = new Elephant() 

{ Name = "Lucinda ", 
lloyd = new Elephant() 

{ Name = "Lloyd ", EarSize 


EarSize 


33 


40 


|jf you just fom*t L\o^jA 
{jo U 6 'mda, 七 V^C wm 七 

be a” wove vc*fcvcv\dcs 
-to LloYd, av^d, 
Wis objed 七 』 be lost 
TV^aVs ^ 70U wed 
*to V^avc *tV^c ttoldcv- 
V^old OY\\p 

Lloyd o\)^td 
U 6 *mda ^ 細 c. 


private void buttonl_Click(object sender, EventArgs e) 
lloyd.WhoAml(); 

} 

private void button2_Click(obj ect sender, EventArgs e) 
lucinda.WhoAml(); 


private void button3_Click(obj ect sender, EventArgs^e) ? { 
Elephant holder; TKcv*C s v\o s*ba*te 州⑶七 W *tnC 

]^ld，r = Hoyd; , _ because v/c (Wt _七 

lloyd = lucinda; x ： rc-vcf p <\ » 1 

lucinda = holder; ay\o*t^CV" ms*t3ir\6e or P Cf ^ • 

MessageBox.Show("Objects swapped"); 




- 

Why do you think we didn’t add a Swap () method to the Elephant class? 
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types and references 


Two references means TWO 
ways to change an object's data 

Besides losing all the references to an object, when 
you have multiple references to an object, you can 
unintentionally change an object. In other words, one 
reference to an object may change that object, while 
another reference to that object has no idea that 
something has changed. Watch: 



Add another button to your form. 



Swap 




Add this code for the button. Gan you guess what’s going to happen when you click it? 


This s-tatcrwcht 
says -fco set 
Ea\r£iz^ -fco 午 ? Zl 
oh wha-tcvcv* 
object the lloyd 

"fco poih-t "fco. 



private void button4_Click (object sender, EventArgs e) A-Ptcv- -this Codt VuhS, 

{ both the lloyd 3 hd kmda 

lloyd = lucinda; - - - - " vaviablcs vc-fcire 

lloyd.EarSize = 4321 
lloyd•WhoAmI() 

, 、 \ ， l vwl ' 7 ，/ \ ’^LUa /4 Arvow 



VovaVc taM 

UoA^lO —f 

( 1 ：^ But lloyd poih-ts at the sa^e 
七 Ug that Uihda does. 


V-Ch^C the 

Elcphaht object. 



❺ OK, go ahead and click the new button. Wait a second, that’s the Lucinda message ^epha^ 

box. Didn’t we call the Who Ami () method from Lloyd? 


1 七 ’s \u6mda s 


\) 0 ^ 



f/ephoX^ 


Lucinda says... 


My earsar44321 rnches tall. 


OK 


But wc set this 
EairSiic usihj -the 
lloyd lrc-fcirch^c/ IVhat 
gives? 


Urnda, 6 七 J 


tJoic tha 七七 V^c 
data is NOT W” 
OVCV" … n 七七 cv '— 七 ^ 
OY\\y 七 Wnr\y 
a\rc i\\t 
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pick an object out of a line up 

A special case: arrays 

If you have to keep track of a lot of data of the same type, like a list of heights 
or a group of dogs, you can do it in an array. What makes an array special is 
that it’s a group of variables that’s treated as one object. An array gives you 
a way of storing and changing more than one piece of data without having to 
keep track of each variable individually. When you create an array, you declare 
it just like any other variable, with a name and a type: 


Strings and arrays are different 
from the other data types you’ve 
seen so far, because they’re 
the only ones without a set size 
(think about that for a bit). 


u dtcUrt ayv by 

Wlov/cd 

\)\j scyudv^e 


s 


>u use -the keywovd 
■to Cxtdi^t a\r\ray bemuse 
its ^y\ object So 
away variable is a k'md o( 

variable- 


_^ bool[] myArray; 

new bool 


fe ou,d i ombihc ⑽⑽。 ” 

… y/Way variable with it 

like , 

鐵 T ㈣ | ook = 


hool ° ^ ^cw booir/^j ； 


TWis av-v-ay Kas I ^ 
clcw'C^ts v/rtWm rt. 


myArray 





myArray[4] 


true; < 



This Ue sets the value o( 

Use each element in an array like 
it is a normal variable 私 e ^ tond is «> 丫知叫 [| ]，也 

When you use an array, first you need to declare a reference 
variable that points to the array. Then you need to create the 
array object using the new statement, specifying how big you 
want the array to be. Then you can set the elements in the 
array. Here’s an example of code that declares and fills up an 
array — and what’s happening on the heap when you do it. The 
first element in the array has an index of zero. 

The -type ~ 

o( 

dement m 


,S sW as = 

^ ^ 1 Me mt 
tV>eve ave 

cables 一 tW 比 . 


v\awc 


int[] heights; 
heights = new int[7]; 


■the avv-ay. 
You 

tV^csc V>7 

eaA ot\t 
YJOV*ks 

csscv\"t'»3^7 

like a ^ov-wal 
•m*t vav'»ablc- 


heights[0] 
heights[1] 
heights[2] 
heights[3] 
heights[4] 
heights[5] 
heights[6] 








68 ; 

70; 

63; 

60; 

58; 

72; 

74; 



Notice avvay is object 

cvc 灼 -the 1 elements a\rc \us*t 
value -types—like o 灼 cs o 灼 -the -fiv-s*t 

*t>/o pajes -this dhaftev-. 
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types and references 


Arrays can contain a bunch of 
reference variables, too 



imniooinoini 


You can create an array of object references just like you create an 
array of numbers or strings. Arrays don’t care what type of variable 
they store; it’s up to you. So you can have an array of ints, or an 
array of Duck objects, with no problem. 

Here’s code that creates an array of seven Dog variables. The line 
that initializes the array only creates reference variables. Since there 
are only two new Dog () lines, only two actual instances of the Dog 
class are created. 


Dog[] dogs = new Dog[7]; 
dogs[5] = new Dog(); 
dogs[0] = new Dog(); 

These two lihes ev'caic hew 

PogO ahd put 
at ihdexes O ^hd 


TVis Ime dedaw a 

do^s vav-iablc bo hold a 灼 

av-v-av *to 

poj objects, 3 r\d 

dv-ca*tcs a scvcr\-clcmc^*b 


Wken you set or 
retrieve an element 
from an array，tke 
nuititer inside tke 
brackets is called 
tke index. Tke lirst 
element in tke array 
kas an index oi zero. 






\c\\ ^ cdvxS 




avv-ay. 


Oog 0 


7 Dog variables 


nc Wst w d codto^i 
seated avrap 0 七七 hc 

msla^cs. nc a 叫 “ 
W ⑽ P 吒 

vahaWcs. 


All o-f clcmcirrb m *thc av-vay av-c 
\rc*fc\rc^dcs. The av-v-ay i*bcl*f is a 灼 object 
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sloppy joe sez: “it’s not old, it’s vintage 




Welcome to Sloppy Joe's budget House o’ Piscount Sandwiches! 


Sloppy Joe has a pile of meat, a whole lotta bread, and more condiments 
than you can shake a stick at. But what he doesn’t have is a menu! Gan 
you build a program that makes a new random menu for him ever 


o 



Start a new project and add a MenuMaker class. 

If you need to build a menu, you need ingredients. And arrays would be perfect 
for those lists. We’ll also need some way of choosing random ingredients to 
combine together into a sandwich. Luckily, the .NET Framework has a built-in 
class called Random that generates random numbers. So we’ll have four fields 
in our class: a Randomizer field that holds a reference to a Random object, and 
three arrays of strings to hold the meats, condiments, and breads. 


MenuMaker 


Randomizer 

Meats 

Condiments 

Breads 


GetMenultemQ 


Tiic -f ield dallcd 

Kolds 

a Yt^cctr\tt b> a 

Random objc£.*t- 

Call'm^ »*b Ne% 七 0 

method >w»ll 


class MenuMaker 
public Random 


Randomizer; 


The dlass has 七 hiree -fields -to 
s-fcov-c thvee di-f-Pcvchi avvays o( 

广 siv'mjs. Itll use therw -to build 

^ ^ \rair>donr» i-tcnr»s. 


string[] 
string[] 


Meats 


'Roast beef' 


Salami 


Turkey' 


Ham' 


Pastrami 


Condiments = { "yellow mustard ", "brown mustard ", 

"honey mustard ", n mayo n , "relish ", "french dressing" }; 

string [ ] Breads = { "rye" , "white ，'， "wheat" , "pumpernickel ", 


Notice hov/ you vc 
these 

av-v-ays? ThaVs 
called a dollc 匕七 icm 
By\A 

you’ll led\nrt all 
about i*t m 
Chapicv- 0. 



italian bread' 


’a roll" }; 



RcmCrwbcV-, use S 

SCCcss d member 
value o( Bv-cadsCZ3 is 


<\ua\rc bv-a^kets -to 
o( By\ av-vay.Thc 


a GetMenuItem() method to the class that generates a random sandwich. 

The point of the class is to generate sandwiches, so let’s add a method to do exactly that. It’ll use 
the Random object’s Next () method to choose a random meat, condiment, and bread from 
each array. When you pass an int parameter to Next (), the method returns a random number 
that’s less than that parameter. So if your Random object is called Randomizer, then calling 
Randomizer . Next (7) will return a random number between 0 and 6. 

So how do you know what parameter to pass into the Next () method? Well, that’s easy~just 
pass in each array’s Length. That will return the index of a random item in the array. 


The 

method \rC*tuV-^s 
a strmg that 
doivtsms a 
built -fv-om 

av-v-ays. 


public string GetMenuItem() { 

string randomMeat = Meats[Randomizer.Next(Meats.Length)]; 
string randomCondiment = Condiments[Randomizer.Next(Condiments.Length)] 
string randomBread = Breads[Randomizer.Next(Breads.Length)]; 



return randomMeat 


with 


randomCondiment 


on 



The method puts a i-tem -fvom the Meats 

passm^ Mcats.*to -the Random 
-five items \ y \ the avvay, Mca*ts-L-c 

random between 0 and 午 . 


bhc Z^cats av-ray 

bjcdVs m 

is so N« 


+ randomBread; 

m*to randomMeat by 
rthod. thcv-c sre 

will 代七价灼 a 
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H—it 御 ijs”. 

Ibt _r .， 勤 t U 咖 ）— y 。 ㈠ ,a,do. 

IL 巧 ，。 — Wo , but less tha, 

the humbc\r o+ clcmchts ih the /Wcats 針 ay. 


Meats[Randomizer.Next(Meats.Length)] 


-Roast B«Od 融 B]——. 


I BAT AUU MY 
MBAUS AT SUOPPV 
JOB^L 




⑩ Build your form. 

Add six labels to the form, labell through label 6. Then add code to set each label’s 
Text property using a MenuMaker object. You’ll need to initialize the object using a new 


instance of the Random class. Here’s the code: 

public Forml () { 

InitializeComponent (); 


Use a 灼 objeti -to sci ihc 

/VIc>r>u/l/Iakc\r objed-t's Rdhdomiz^r -field -to 
^ ms-tahde o( -the Random class. 


MenuMaker menu = new MenuMaker () { 


labell.Text 
label2.Text 
label3.Text 
label4•Text 
label5.Text 
label6•Text 


=menu.GetMenuItem(); 
=menu.GetMenuItem(); 
=menu.GetMenuItem(); 
=menu.GetMenuItem(); 
=menu.GetMenuItem(); 
=menu.GetMenuItem(); 


Randomizer = new Random() }; 



(v/oy/ youVc all sc*t *to 
^cr\cva*tc si% di-f-fcv-cr\*t 

vd^dom sar>dv/i 如 s us'm^ 
^C*tMc^u|*tcrwO method- 


]/\l\\CY\ Y 0U 矿⑽ 仏 c 

^y-O^V*dw\) "t^C labels 

sV)0\^/ di^cv*cy\*t 

vdy\diovn 



□□ 


Sloppy Joe"s Menu 



Salami with honey mustard on white 
Pastrami with french dressing on pumpernickel 
Turkey with honey mustard on italian bread 
Ham with yellow mustard on pumpernickel 
Turkey with honey mustard on pumpernickel 
Turkey with yellow mustard on wheat 


ttevVs something 
■fco -thmk about 
lA/ha-t would 
happen i*f you 
-fov-jo-t "to 
’mrtialiic the 
Mc^uMakcv- 
objed^s 
Ra^dorwizjCV* 
-field? Ca^ you 
"thmk o( a way 
■to keep 七 his 
-rv-orw 
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your object’s a chatty cathy 


Objects use references to talk to each other 

So far, you’ve seen forms talk to objects by using reference variables to call their 
methods and check their fields. Objects can call one another’s methods using 
references, too. In fact, there’s nothing that a form can do that your objects can’t do, 
because your form is just another object. And when objects talk to each other, 
one useful keyword that they have is this. Any time an object uses the this keyword, 
it’s referring to itself — it’s a reference that points to the object that calls it. 

O A TO TBUU AN BUBPHAhJT TO SP5AK. 

Let’s add a method to the Elephant class. Its first parameter is a message from an 
elephant. Its second parameter is the elephant that said it: 

public void TellMe(string message. Elephant whoSaidlt) { 

MessageBox•Show(whoSaidlt•Name + " says : " + message); 

} 

Here’s what it looks like when it’s called. You can add to button4 一 Click (), but add it 

before the statement that resets the references! (lloyd = lucinda;) 

lloyd.TellMe("Hi", lucinda); 

We called Lloyd’s TellMe () method, and passed it two parameters: “Hi” and a reference to 
Lucinda’s object. The method uses its whoSaidlt parameter to access the Name parameter 
of whatever elephant was passed into TellMe () using its second parameter. 


Elephant 

Name 

EarSize 


WhoAml() 

TellMe() 

SpeakTo() 


@ A THAT CAUUS AN0TH5I2 

Now let’s add this SpeakTo () method to the Elephant class. It uses a special keyword: 
this. That’s a reference that lets an object talk about itself. 

public void SpeakTo(Elephant whoToTalkTo, string message) { 

whoToTalkTo. TellMe (message, this) ； ^ 七 ^ ^,1 ,| ass da || s a.othe, 

} TalkToO method. |*t lets or\e 

Let’s take a closer look at how this works. doi^i^u^ida*tc 3no*tKev* one. 

lloyd.SpeakTo(lucinda, "Hello"); 


When Lloyd’s SpeakTo () method is called, it uses its whoToTalkTo parameter (which has a 
reference to Lucinda) to call Lucinda’s TellMe () method. 


whoToTalkTo.TellMe(message, this); 


Lloyd uses whoToTalkTo 
(which has a reference to 
<Lucinda) to call TellMe (). 

lucinda•TellMe(message, [a reference to Lloyd]); 


this is replaced 
.with a reference to 
^jJoyd’s object. 


So Lucinda acts as if she was called with ("Hello", lloyd), and shows this message: 


Lloyd says; Hello 


OK 
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Where wo object has gone before 


There’s another important keyword that you’ll use with objects. 
When you create a new reference and don’t set it to anything, it has 
a value. It starts off set to null, which means it’s not pointing to 



Dog fido; 



Right how, ohly 

objedt. The *f ido 
\rc-fc\rchdc is set to hull. 


Dog lucky = new Dog(); 



fido = new Dog(); 


Kow that fido’s po'mtmj 


h> ^y\ object, i*b ； s 
lo^yv* "to y \[ a \\- 




\ ob， c ' 



lucky = 


null; 


W\\tv\ y/c set ludky h> ^ull, 
its y\o lo^jcv- pomtmj at its 
ob\c^t, so it jets jav-baje- 

dolWed. 






% One more time—my form is an 
object? 

A! Yes! That’s why your form's code starts 
with a class declaration. Open up code for 
a form and see for yourself. Then open up 
Program.es in any program you’ve written so 
far and look inside the Main () method— 
you'll find "new Forml () 

Why would I ever use null? 

There are a few ways you see null 
used in typical programs. The most common 
way is testing for it: 


if (lloyd — null) { 

That test will return true if the lloyd 
reference is set to null. 

Another way you’ll see the null keyword 
used is when you want your object to get 
garbage-collected. If you’ve got a reference 
to an object and you’re finished with the 
object, setting the reference to null will 
immediately mark it for collection (unless 
there's another reference to it somewhere). 

You keep talking about garbage 
collecting, but what’s actually doing the 
collecting? 


Remember how we talked about the 
Common Language Runtime (or CLR) 

back at the beginning of Chapter 2? That’s 
the virtual machine that runs all .NET 
programs. A virtual machine is a way for it 
to isolate running programs from the rest of 
the operating system. One thing that virtual 
machines do is manage the memory that 
they use. That means that it keeps track of 
all of your objects, figures out when the last 
reference to the object disappears, and frees 
up the memory that it was using. 


you are here ► 
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this and that 


D 


there J are no 

)umb Qv 


Questi9ns 


I’m still not sure I get how 
references work. 

A! References are the way you use allot the 
methods and fields in an object. If you create a 
reference to a Dog object, you can then use 
that reference to access any methods you’ve 
created for the Dog object. If you have a 
(nonstatic) method called Dog. Bark () or 
Dog. Beg () , you can create a reference 
called spot. Then you can use that to access 
spot. Bark () or spot . Beg ( ). You 
could also change information in the fields for 
the object using the reference. So you could 
change a Breed field using spot • Breed. 

Wait, then doesn’t that mean that 
every time I change a value through a 
reference I’m changing it for all of the 
other references to that object, too? 

A: Yes. If rover is a reference to the 
same object as spot, changing rover. 
Breed to “beagle” would make it so that 
spot . Breed was “beagle ■” 


I still don’t get that stuff about 
different types holding different sized 
values. What’s the deal with that? 

OK. The thing about variables is they 
assign a size to your number no matter how 
big its value is. So if you name a variable 
and give it a long type even though the 
number is really small (like, say, 5), the CLR 
sets aside enough memory for it to get really 
big. When you think about it, that’s really 
useful. After all, they’re called variables 
because they change all the time. 


The CLR assumes you know what you’re 
doing and you’re not going to give a variable 
a type that you don’t need. So even though 
the number might not be big now, there’s a 
chance that after some math happens, it’ll 
change. The CLR gives it enough memory 
to handle whatever type of number you call it. 

Remind me again—what does 

this do? 


this is a special variable that you 
can only use inside an object. When you’re 
inside a class, you use this to refer 
to any field or method of that particular 
instance. It’s especially useful when you’re 
working with a class whose methods call 
other classes. One object can use it to send 
a reference to itself to another object. So 
if Spot calls one of Rover's methods 
passing this as a parameter, he’s giving 
Rover a reference to the Spot object. 


Any time you’ve got 
cocte in an otject 
tliat’s going to te 
instantiatect, tke 


instance can use tke 
special tkis variable 
tkat ltas a reierence 


^^BULLIT POINTS 


to itself. 

( There’s a vcv-y spedi-f id dase you dor / 七 declare a type. You II 
、 lca\nr\ dbou*t it v/hc 的 you use va\r keyv/ovd Chap*tc\r I 午 . 


When you declare a variable you specify a type and a 
variable name. Sometimes you combine it with setting 
the value on the same line of code. 

There are value types for variables that hold different 
sizes of numbers. The biggest numbers should be of the 
type long and the smallest ones (up to 255) can be 
declared as bytes. 

Every value type has a size, and you can’t put a value of 
a bigger type into a smaller variable, no matter what the 
actual size of the data is. 

When you’re using literal values, use the F suffix to 
indicate a float (15.6F) and M for a decimal (36.12M). 


There are a few types (like short to int) that C# 
knows how to convert automatically. When the compiler 
won’t let you set a variable equal to a value of a different 
type, that’s when you need to cast it. 

There are some words that are reserved by the 
language and you can’t name your variables with them. 
They're words like for, while, using, new, and 
others that do specific things in the language. 

References are like labels: you can have as many 
references to an object as you want, and they all refer to 
the same thing. 

If an object doesn’t have any references to it, it 
eventually gets garbage-collected. 
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c^^rpen your pencil 


Here’s an array of Elephant objects and a loop that will go through 
it and find the one with the biggest ears. What’s the value of the 
biggestEars . Ears after each iteration of the for loop? 


private void buttonl Click(object sender, EventArgs e) 


Elephant[] elephants = new Elephant[7]; 
elephants[0] = ne\ 
elephants[1] = ne\ 
elephants[2] = ne\ 
elephants[3] = ne\ 
elephants[4] = ne\ 
elephants[5] = ne\ 
elephants[6] = ne\ 



WlcVc av-vay of 

severe 卟 a 灼七 (） 


Elephant ( ) 

{ Name = 

"Lloyd ", 

EarSize — . 

40 }; X 

tvev-y av-v-ay 

s-tav*ts 

Elephant ( ) 

{ Name = 

"Lucinda 

" ,EarSize 

= 33 }; \ 

Elephant() 

{ Name = 

"Larry ", 

EarSize —— 

42 }; \ 

0, so 

Elephant( ) 

{ Name = 

"Lucille 

" ,EarSize 

=32 }; \ 

m av-v-ay 

Elephant () 

{ Name = 

"Lars " , 

EarSize 二 

44 }; 


Elephant () 

{ Name = 

"Linda ", 

EarSize = 

37 }; i 


Elephant () 

{ Name = 

"Humphrey ", EarSize = 45 }; / 



Iteration #1 biggestEars.EarSize 


Elephant biggestEars = elephants[0]; 

for (int i = 1; i < elephants.Length; i++) 


Iteration #2 biggestEars.EarSize 
if (elephants[i].EarSize > biggestEars.EarSize) 


biggestEars = elephants[i]; 




This lihe makes the biggcs-tEav-s 
poiht at whatcvcv* 

} elepkhrt dcphoihtstiJ foihts -to. 

MessageBox.Show(biggestEars.EarSize.ToString()); 


Iteration #3 biggestEars.EarSize 


Iteration #4 biggestEars.EarSize 


t 


Be tav-c-ful—*tKis loop s*ta\rts 
y/rtii setor^di clcr^cr\*t c^f 
avvay mdc% I) i*tcva*tcs 

si% times uyrtil i is *to 

av-v-ay- 


Iteration #5 biggestEars.EarSize 


Iteration #6 biggestEars.EarSize 


♦ Answers on page 184 . 


you are here ► 
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code magnets and pool puzzle 


= Fiji 

= Cozumel 
= Bermuda 
= Azores 


OK 



Code Magnets 


The code for a button is all scrambled up on the fridge. Can you 
reconstruct the code snippets to make a working method that 
produces the output listed below? 



refNum = index[y]; 




int refNum; 


while (y < 4 ) { 



string[] islands = new string [ 4]; 





y = y 


private void buttonl_ciick (object 


sender, EventArgs e) 



string result 


d d d d 
n n nn 
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Paa] Puzzjc 

Your job is to take code snippets 
from the pool and place them 
into the blank lines in the 
code. You may use the same 
snippet more than once, and 
you won’t need to use all the 
snippets. Your goal is to make 
a class that will compile and run, 
and produce the output listed. 


Output 


triangle 0 r area = 4 
triangle 1 r area = 10 
triangle4 area = IS 
triangle 3 r area 

y= _ 





Bonus Question! 

For extra bonus points, use snippets 
from the pool to fill in the two blanks 
missing from the output. 


Note: each snippet from 
the pool can be used 
more than once. 


class Triangle 


area 

ta.area 

ta.x.area 

ta[x].area 


4, t5 area = 18 
4, t5 area = 343 
27, t5 area = 18 
27, t5 area = 343 
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double area; 
int height; 
int length; 
public static void Main(string[] args) 
{ 

string results = 


while ( 
{ 


.height = (x + 1) * 2; 

.length = x + 4; 


results +: 
results +: 


'triangle 


x + 
area 


area 

"\ n " 


x = 2 7; 
Triangle t5 
ta[2 ].area : 
results += 


=ta [2]; 

= 343; 

'y = " + y; 


MessageBox.Show(results + 

" , t5 area = " + t5.area); 


void setArea() 



SctAv-caO 
,s NOT a 
static w>c*t^od. 
Flip batk -to 
CV^aptcv- -fov- 
a v-c-fv-csVicv- OY\ 

kcyv/ovd 


(height * length) / 2; 


Triangle [] ta = newTriangle(4); 
Triangle ta = new [ ] Triangle[4]; 
Triangle [] ta = newTriangle[4]; 


ta[x] = setArea (); 
ta.x = setAreaO; 
ta[x].set Area (); 


nt y = x; 
28 


ta.x 
ta(x) 
ta[x] 

ta = newTriangleO; 
q ta[x] = newTriangleO; 
ta.x = newTriangleQ; 


♦ Answers on page 186. 

you are here ► 
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this looks fun 


Puild a typing game 


You’ve reached a milestone...you know enough to build a game! Here’s how your game will 
work. The form will display random letters. If the player types one of them, it disappears 
and the accuracy rate goes up. If the player types an incorrect letter, the accuracy rate 
goes down. As the player keeps typing letters, the game goes faster and faster, getting more 
difficult with each correct letter. If the form fills up with letters, the game is over! 



as 


參 




Hit the keys! 


D 




Correct: 9 Missed: 1 Total: 10 Accuracy: §0% 


Difficulty 


⑤ BUIUt> THB PO 訊 • 

Here’s what the form will look like in the form designer: 



You’ll need to: 

★ Turn off the minimize box and maximize box. Then set the form’s FormBorderStyle 
property to Fixed3D. That way, the player won’t be able to accidentally drag and resize it. 

Then resize it so that it’s much wider than it is tall (we set our form’s size to 876, 174). 

★ Drag a ListBox out of the toolbox onto the form. Set its Dock property to Fill, and its 
MultiColumn property to True. Set its Font to 72 point bold. 

* In the toolbox, expand the All Windows Forms group at the top. This will display many 
controls. Find the Timer control and double-click on it to add it to your form. 

* Find the Status Strip in the All Windows Forms group in the toolbox and double-click on it 
to add a status bar to your form. You should now see the StatusStrip and Timer icons in the 
gray area at the bottom of the form designer: 

I See how you can use a Timer to make your form 
I do more than one thing at once? Take a minute 
and flip to #4 in the “Leftovers” appendix to 
learn about another way to do that. 




® timerl Li statusStripl 
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ser up we STATUSsmtp conmou 
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You’ll be using three new 
controls, but they’re easy 
to work with! 


Take a closer look at the status bar at the bottom of the 
screenshot. On one side, it’s got a series of labels: 

Correct: 18 Missed: 3 Total: 21 Accuracy: 85% 


And on the other side, it’s got a label and a progress bar: 

Difficulty _ 


Even though you haven’t seen a ListBox, 
StatusStrip, or Timer before, you already 
know how to set their properties and work 
with them in your code. You’ll learn a lot 
more about them in the next few chapters. 


Add a StatusLabel to your Status Strip by clicking its drop-down and selecting 
StatusLabel. Then do the following: 

★ Use the Properties window to set its (Name) to correctLabel and its 
Text to “Correct: 0”. Add three more StatusLabels: missedLabel, 
totalLabel, and accuracyLabel, and set their Text properties to 
“Missed: 0 ”， “Total: 0”, and 'Accuracy: 0%”. 


0 

▼ 


A 

StatusLabel 


ED 

ProgressBar 



DropDownButton 


03 

SplitButton 



* Add one more StatusLabel. Set its Spring to True, TextAlign to MiddleRight, and Text to 
“Difficulty”. Finally, add a ProgressBar and name it difficulty Progress Bar. 


★ Set the StatusStrip’s SizingGrip property to False (hit Escape if you’ve got a child StatusLabel or 
ProgressBar selected to return the IDE’s focus to the parent Status Strip). 


(g) SBT UP THB TIM 5 S 

Did you notice how your Timer control didn’t show up on your form? That’s because 
the Timer is a nonvisual control. It doesn’t actually change the look and feel of the 
form. It does exactly one thing: it calls a method over and over again. Set the 
Timer control’s Interval property to 800, so that it calls its method every 800 
milliseconds. Then double-click on the timerl icon in the designer. The IDE will 
do what it always does when you double-click on a control: it will add a method to 
your form. This time, it’ll add one called timerl 一 Tick. Here’s the code for it: 



private void timerl Tick(object sender, EventArgs e) 


// Add a random key to the ListBox 

listBoxl.Items.Add((Keys)random.Next(65, 90)); 

if (listBoxl • 工 terns•Count > 7) 


You’ll add a -field 匕 ailed 

w V"3K\diom W m jus*b 3 
Can you jucss »*b 
-type >will be? 


listBoxl. 工 terns•Clear(); 
listBoxl. 工 terns•Add("Game over"); 
timerl.Stop (); 

} A, Thc Ti ? 饮 dass has a SlavtO method, but 

} V / OU doh ^ ^ dal1 ^ ^ this 

youll sci its Eh^bled pvopcvty io 

TVua whidh it s-birt au-tor^atidally. 
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the key to a great game 


w 



At>t> A CLASS TO KBBP V2ACK OF THB PLAYB12 STATS- 

If the form is going to display the total number of keys the player pressed, the number that 
were missed and the number that were correct, and the player’s accuracy, then we’ll need 
a way to keep track of all that data. Sounds like a job for a new class! Add a class called 
Stats to your project. It’ll have four int fields called Total, Missed, Correct, and 
Accuracy, and a method called Update with one bool parameter: true if the player 
typed a correct letter that was in the ListBox, or false if the player missed one. 

class Stats 



public 

public 

public 

public 


int Total = 0; 
int Missed = 0; 
int Correct = 0; 
int Accuracy = 0; 


public void Update(bool correctKey) 

{ 

Total++; 


if ( !correctKey) 

{ 

Missed++; 

} 

else 

{ 

Correct++; 



£vcv-y hrrst the Upda-tcO method is 
called, i*t v-cdaldulatcs -the % dov-v-cd-t 
puts i-t m -the -field- 


Accuracy = 100 * Correct / (Missed + Correct); 





/?£>£> FI5L0S TO YOUJZ F^IZM TO H^>U> A STATS OBJECT 
ANt> A !2ANt>^>M OeJBCT^ 

You’ll need an instance of your new Stats class to actually store the information, 
so add a field called stats to store it. And you already saw that you’ll need a field 
called random — it’ll contain a Random object. 

Add the two fields to the top of your form: 

public partial class Forml : Form 

{ 

Random random = new Random (); 

Stats stats = new Stats(); 


Before you go on, there are three properties 
you need to set. Set the Timer control’s 
Enabled property to True, the ProgressBar 
control’s Maximum property to 701, and the 
Form’s KeyPreview property to True. Take 
a minute and figure out why you need those 
properties. What happens if you don’t set them? 
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❻ HANt>UB TUB KBYSm^KBS^ 

There’s one last thing your game needs to do: any time the player hits a key, it needs to check if that key 
is correct (and remove the letter from the ListBox if it is), and update the stats on the StatusStrip. 


orms.Form 



Go back to the form designer and select the form. 

Then go to the Properties window and click on the 
lightning bolt button. Scroll to the Key Down row 
and double-click on it. This tells the IDE to add 
a method called Forml_KeyDown () that gets 
called every time the user presses a key. Here’s the 
code for the method: 

private void Forml KeyDown(object sender, KeyEventArgs e) 


Properties 


Forml System.Win^ 

[f^i 4TI 

InputLanguageChan 


KeyPress 
Key Up 


Forml _Key Down 


v 


Clidk -this butfccm "to 

"the P\ropc\rtics 
v/mdow’s view. The 
-to ihc Ic-Pt 
o( i-t sy/i-tdhes 七 he 
P\ropc\rtics v/mdov/ 
badk \ a > shov/mj yc 
p\ropc\rtics. 


/ou 


This i-f s*ta*tcmc 灼七 
乙 hedks -the Lis*tBox. 
*to sec i-f i*t 
i\\c key playev 
pressed- I-f \i dots, 
key jc*b 

VCmoVcd TVorn 

ListBox 

jamc di-f-fidul*ty is 
*m^\rcascd. 


// If the user pressed a key that's in the ListBox, 
// and then make the game a little faster 
if (listBoxl. 工 terns•Contains(e.KeyCode)) 


remove it 


listBoxl. 工 terns•Remove(e.KeyCode) 
listBoxl.Refresh(); 
if (timerl • 工 nterval 
timerl. 工 nterval 
if (timerl • 工 nterval 
timerl. 工 nterval 
if (timerl • 工 nterval 
timerl. 工 nterval 
difficultyProgressBar.Value 


These av-c called 
events, ^y\d you II 
leaim a lot move 
about laicv* oy \- 



This is pav 七 md\rcascs 

as *thc playev- jets move keys v-ijht /ou tBr\ 
make jdme easier by amouirrb 

av-c sub*tva^*tcd -fv-om -ti^cv-l l^-tcv-val ； ov- 
makc i*t ha\rdc\r by *md\rcas*m^ 

800 - timerl • 工 nterval; 


// The user pressed a correct key, so update the Stats object 
// by calling its Update() method with the argument true 
stats.Update(true); 


l/Vhch the playev- 
Passes a key, the 
P"o\ny\l 一 ^sCyPoy/hO 

method c,a\\s the 

Stats object’s _) 

UpdatcO method -to 
update the playev- 
3hd thch it 
displays them m -the 
StatusS-tv-ip. 


else 

{ 


// The user pressed an incorrect key, so update the Stats object 
// by calling its Update() method with the argument false 
stats.Update(false); 



// Update the labels 
correctLabel.Text = 
missedLabel.Text =" 
totalLabel.Text = 
accuracyLabel.Text 


on the StatusStrip 
"Correct : " + stats.Correct; 
"Missed : " + stats.Missed; 

Total : " + stats.Total; 

="Accuracy : " + stats.Accuracy 


% 


This game only 
runs once. Can 
you figure out how 
to modify it so the 
player can start a 
new game when 
it’s displaying 
“Game Over ”？ 


❹ SUN YOUJZ 似 Atg. 

Your game’s done! Give it a shot and see how well you do. You may need to adjust the font size of the 
ListBox to make sure it holds exactly seven letters, and you can change the difficulty by adjusting the values 
that are subtracted from timerl . Interval in the Forml KeyDown () method. 

參一 
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take control of your controls 


Controls are objects, just like any other object 


You’ve built plenty of forms by dragging controls out of the toolbox. It turns out that those controls are 
just regular old objects. And since they’re objects, you can add references to them and work with them 
like you’d work with an instance of a class that you wrote yourself. Let’s see a live example of that by 
building a program that animates some Label controls by bouncing them back and forth on a form. 



Create a new Windows Forms Application and build this form 


Drag three Labels and three Buttons 
onto the form. Double-click on 
each of the buttons to add an event 
handler method for each of them. 



Drag a Timer onto the form and use the 
Properties window to set its Enabled 
property to True and its Interval property 
to 1. Then double-click on it to add the 
timerl Tick () event handler method. 


b 9 Bouncing Labels 

label 1 
Iabel2 
label 3 

button 1 
button2 
button3 


II 回 ll^»l 


-cr 




o 


® timerl 


Add a class called LabelBouncer. Here’s the code for it: 


YOU II Y\ttd 

七 his w usm^ w 
Ime bcdausc 
Label is \y\ 


using System.Windows.Forms; 

class LabelBouncer { 

public Label MyLabel; 




public bool GoingForward = true; 


丁 he AlovcO method -fi^uves ou-t 
i-f the label has hi-t -the vijht . 
cdjc o( the -form by usih^ >— 

■to dhcdk i-P i-b Lc-Pi pvopev-ty 

is efr c<\ual -fco 七 he 

v/idih o( the -Porrw. 


I/Vhy do you tU v/e t\tt& -to 
subtv-adi ihc widih o( the label 
-P\rom 七 he v/i dth o( ihc -Po\rrw? 


public void Move() { 

if (MyLabel != null) { 

if (GoingForward == true) 
MyLabel.Left += 5; 
if (MyLabel.Left > 
GoingForward = 



This class has a -field called MyLabel with i\\c type 
Label, rweans i 七 holds a -to a Label 

object Like all i-t starb out ^ull. li 

will yt se 七 ov\t o( the labels ov\ ihc -Povm. 


This Booled)^ -flips -f\rom *t\ruc *bo -false *to 
tv-uc a^a'm as -the label bou^^cs badk and 
•fourth a^v-oss the -fov-m. 


else 

{ 
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MyLabel.Left -= 5; 
if (MyLabel.Left <= 0) { 

GoingForward = true; 

W 

W\\tY\ you dv-a^ a do 灼 *brol avou 灼 d 
a -Pov-m, IP£ sc*b *thc "Top ar>d 
Lc-P*t fvofcv-*tics. Youv fv-ojvams 
use -these fV-ofC\rtics *to move 
dor>*tvols around -the -povm. 


MyLabel.Parent.Width - MyLabel.Width) 
false; 

: All you need to do to bounce a label across 
a form is to create a new instance of the 
LabelBouncer class, set its MyLabel field to 
point to a Label control on the form, and then call 
its Move () method over and over again. 


: Each time the Move () method is called, the 
•LabelBouncer nudges the label by changing 
: its Left property. If the GoingForward field 
: is true, then it nudges it to the right by adding 5; 
otherwise, it nudges it to the left by subtracting 5. 

: Every control has a Parent property that 
contains a reference to the form, because the 
form is an object too! 
































types and references 

Here’s the code for the form. See if you can figure out exactly what’s going on here. 

It uses an array of LabelBouncer objects to bounce labels back and forth, and has the 
Timer’s Tick event handler method call their Move () methods over and over again. 


參 


public partial class Forml : Form { 

public Forml() { 

工 nitializeComponent(); 


LabelBouncer[] bouncers = new LabelBouncer[3]; 


The form stores an array of LabelBouncer references in 
a field called bouncers. When the ToggleBouncing () 
method is called, it uses the index parameter to check 
an element of the array. If the element is null, it creates a 
new LabelBouncer object and stores its reference in the 
array ； otherwise, it clears the element by setting it to null. 


private void ToggleBouncing (int index. Label labelToBounce) 


button tails 
七 he TogjIcBouhd'm^O 
method ， fass'm^ i*t 
by\ mdc% ok by\ avv-ay 

a 灼 d a *to 

o( Labels OY\ 
•the -Pov-» 


if (bouncers[index] == null) { 

bouncers[index] = new LabelBouncer(); 
bouncers[index].MyLabel = labelToBounce 

} 

else { 

bouncers[index] = null; 




Car> you 

-Pollow c>^ad*tly 

whats jomj 

。灼 W\{\\ the 

button CVCir>*t 
har>dlcv-s? 

is *to 

-fi^uve ou*t how 
they 七 uv 灼七 he 
bour>d'ma oy\ 

a^d (or 
七 he labels. 


private void buttonl_Click (object sender, EventArgs e) 
ToggleBouncing(0 , labell); 


private void button2_Click (object sender ( 
ToggleBouncing(1, label2); 


EventArgs e) 


private void button3_Click (object sender ( 
ToggleBouncing(2, label3); 


EventArgs e) 


private void timerl 一 Tick (object sender, 
for (int i = 0; i < 3; i++) { 

if (bouncers[i] != null) { 

bouncers[i].Move(); 


EventArgs e) { 


Since 

controls are 
just objects ， 
you can pass 
references 
to tkem as 
metkoct 
parameters 
and store 
tkem in 
arrays ， lielcts ， 
and variables. 



The Timcv- uses a -pov loof 
•to dall eadh LabclBou^dcrs 
MovcO method ， bu 七 only 

if i*t’s 灼。七灼 ull. Scttmj 
element *to ywa\\ s*tofs -Pv-om 

bour>d'm^ 士 ovm. 


□ 


button 1 


button! 


button3 


Bouncing Labels 


labell 




Iabel2 


Iabel3 




Clidk buttonl *to s*t3\rt label 1 
boWm} Clidk i*t ay’m *to siof 

i 七 . The o*tKcv *two buttons 
dor>*tv*ol the o-thev- two labels. 


丁 he labels will keep 
— bouh^ihg the 

^ °*f the 

even i-p you dv~ag it 
widev* oV" hdirirowcv*. 
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exercise solutions 



There are about 77 reserved words called keywords in C#. These are words reserved by the C# 
compiler; you can’t use them for variable names. You'll know a lot of them really well by the time you 
finish the book. Here are some you’ve already used. Write down what you think these words do in C#. 


namespace 


for 


class 


public 


else 


new 


using 


if 


while 


Msmcspsdcs make su\rc 灼 ames you a\rc us*m(\ Vouv- do^*t Collide 

wi*th ov\ts \y\ *thc NBT Fv-amcy/o\rk o\r o*thcv external dldsses vou^vc used m Vou\r 

P\roa^m. All oir /lUss 产 S ^y\/i iy\ A P\roa\r^r»\ Are iy\si/i^ A 

\ J 1 l J \ 

This lets you do a loop 七 c>^cdu*tcs *tWec s*ta*tcmc^*ts. Pivs*t i 七 dedlaves *thc 

variable its (\o\y\<\ *to use, 的 *thc\rc’s 七 he s*ta*tcme 灼七 evaluates variable 

d^d'ms-t B do 灼 di*tio 灼 . The *thiv-dl s*ta*tcmc^*t does *to value- 


A dldss is how you dc-fmc By\ ob\cdt Classes have pv-opcv-*tics d^d methods. 

P\roPc\r*tics av-c y/Ka*t *thcv k^ov/ ^Y\d mc*tKodls av-c y/ha*t *thcv do. 

» / / 


A Public dass be used bv cvev-v o*thc\r t\Bss m pv-o\cdt W\\cy\ d variable ov- 

mrthod is declared as public, i*t cby\ be used bv classes a^d 匕 ailed bv methods av-c 

• / / 

ou+siric of +.1^ ome i^s Aef\^crA jy\. 

J 

Code 七 s*ta\rts W\{\\ else v/ill <\e 七 i-r i-r pv-c^cd*m<\ i*t -fails. 




You use *this *to dvca*tc d Y\t^i 'ms*ta^dc By\ ob\cdt 




This is a y/av o-r-r dll c^r *thc ^amcspa^cs vou avc us*m(\ *m Vouv p\ro<\\ram. us*m<\ 

Ic-ts Vou use toAt -f\rom *tlic -NET Fvamcy/o\rk 3 灼 dl P\rcdc-f*mcd dbsscs *(Vom Parties 

/ * * 

；K w 产 II ；K v/rtu /»^y\ V/«UV"Sr|-f- 

/ / 

TKis is erne y/3V o4 - sc*ttm<\ up ^ ^o^ditio^al sh'temeirrt m a PV-o<\var»\. 

/ J \ 1 J 

14*. SAVS i*P oy\^ is *l".\ru 产， /io oy\P i-(* y\o-f.. /io f. 



while loops avc loops *tha*t keep or\ as loir\(\ as *thc do^di*tio^ *m is *bruc. 
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Typecross Solution 
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exercise solutions 

- ^^^rpen your pencil 


Here’s an array of Elephant objects and a loop that will go through 
it and find the one with the biggest ears. What’s the value of the 
biggestEars . Ears after each iteration of the for loop? 


private void buttonl Click(object sender, EventArgs e) 


Elephant[] elephants = new Elephant[7] 


卽 


elephants[0] 

=new 

Elephant() 

{ Name = 

"Lloyd ", 

EarSize —. 

40 

elephants[1] 

=new 

Elephant() 

{ Name = 

"Lucinda 

",EarSize 

= 

elephants[2] 

=new 

Elephant() 

{ Name = 

"Larry ", 

EarSize —. 

42 

elephants[3] 

=new 

Elephant() 

{ Name = 

"Lucille 

",EarSize 

= 

elephants[4] 

=new 

Elephant() 

{ Name = 

"Lars ", 

EarSize 二 

44 

elephants[5] 

=new 

Elephant() 

{ Name = 

"Linda ", 

EarSize = 

37 

elephants[6] 

=new 

Elephant() 

{ Name = 

"Humphrey ", EarSize = 




t 


St 


32 



Iteration #1 biggestEars.EarSize 


Elephant biggestEars = elephants[0]; 

for (int i = 1; i < elephants.Length; i++) 


Iteration #2 biggestEars.EarSize 
if (elephants[i].EarSize > biggestEars.EarSize) 

/ [T\r\c biggcs-tEav-s 

{ is used io 

biggestEars = elephants[i] "t\radk o-f 

Use debu 5 ^ dKedk 士略七 weV see, whi | c Iteration #3 biggestEars.EarSize 

- Pu*t youv bvcakpo*m*t Kcvc 901^9 thirough the -Po\r 

®} arsd loo P ki 99«t 


cav-s so -Pav-. 

MessageBox.Show(biggestEars.EarSize.ToString()); 


T\\t (or loop s*tav*b W\i\\ *tKc second ar\d 

tompav-cs i*t *to v/iia*tcvcv bi^cstEav-s * 

pomts -to. 1^ its cavs avc bi^cv, \i 
bi^cs*ttav-s at 七 hat clcpKar>*t ms*tcad- The” 1 七 
moves *to or\C> "tKcr> 七 o^c...by 

cr>d o( loop, \>\^tsi^ars fomts {p *tKc o^t 
W\i\\ cavs. 



Iteration #4 biggestEars.EarSize 


Iteration #5 biggestEars.EarSize 


Iteration #6 biggestEars.EarSize 


午 0 


午 z 


午 z 


午午 


午午 


午 *5 
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= Fiji 

= Cozumel 
= Bermuda 
- Azores 


OK 




Code Magnets Solution 

The code for a button is all scrambled up on the fridge. Can you 
reconstruct the code snippets to make a working method that 
produces the output listed below? 




new 


int [ 4 ]; 


yjV\cv*c \ 

\ index[ll = 3; 

•mdc%C3 a 叫 S 



1 index[2] = 

L 

1 index[3] 


string [ ] islands 

. *-= = 

lsl ^nd s [0] 

ls land s [i] 
ls J-ands [2] 
il^ an ^sf3i = 


new string[4]; 


The isla^dsG av-v-ay is 
•mi 七 ializ^d hc\rc- 


int y 


= 0; 


This while loop 
pulls a value -fv-orh 
"the ihdcxO av-^y 
uses ii ^ ov . 

仏 e iy>dcx -the 


int refNum; 
while (y < 4 ) { 




index[y]; 
\nisland 



The vcsul*t s 七 vm— W ， l^ 叶 
+=^ o ? CvaW -to 

七 evxa 七 c Ucs O 山 ’ 七 . 


is^dsCJ 


^\r3y. 


result + = i 


slands[refNum] 


a 





y = 

=y + 



□ 



d d d d 
n n nn 
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Paa] puzzjc §a]utian 


class Triangle 


*bW»s I'mc, 

v,cvc (y>i ^ avvav 
-fouv* Tv>3^^ c 
vc-fcvc^6cs— but 

七 ^ avc〆 七扣 7 
TV«a—e obje 出 7 e 七 ! 


Bonus Answer 


triangleC 
triangle 1 
triangle: 
triangle ^ 
y = 午,杉 

\ area = 4 
r area = 10 

1 area = IS 
! r area = 2 •公 
av-ca - 3 午 3 




OK | 




The sctA'rcaO method 

uses the heigh-t dhd 
length -fields -to set the 
3V"C3 -field- Sih 乙 e i*t’s ho*t 

a static method, it C3iY\ 

o^ly be called -fv-orw mside 

扣 ihS-ta^dc of Tvia^jlc. 


No-tide how -this dlass do^ia'ms 
七 he c^iv-y po*mi ; bu 七 _七 also 
^v*c3*tcs dh ms*toir>dc o-P i*tsd-P? 
Thai^s domplcicly legal m C 养 . 


double area; 
int height; 
int length; 
public static void Main(string[] args) 
{ 

string results =""; 

•m*t x 二 0; 


TViar^leC] 七 a 二 灼 ev/ TViay^le [ 今 "Jj 

while ( 乂 < 午 ) 

{ 

七 3[ 乂] 二 v\t^j Tiria^leOj 


The while loop 
^\rc«|-tcs the -fouv- 
iK>s-tair>^cs o( 


•baC>c3 .height = (x + 1) 
length = x + 4 ; 

taC^JsetAv-caO; 


〆 * m^cmecs OT 

T^ria^glc by 匕 allmg 
the hew s-tafcmch-l 


女 


2 ; 


S-ta-tcimCK>-t 

■fouv -times. 


results +: 
results +: 

+ I ： 


triangle " — 

="+ ta [ 乂 ] 


X 


area 


area 

n \n n , 


•m 七 y 


x = 2 7; 
Triangle t5 
ta[2].area : 
results += 


=ta[2]; 

= 343; 

y = " + y; 

MessageBox.Show(results + 

" , t5 area = " + t5.area); 


void setArea() 


area 


(height * length) / 2; 
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C#Lab 



A Day at the Races 

This lab gives you a spec that describes a program 
for you to build, using the knowledge you’ve gained 
over the last few chapters. 

This project is bigger than the ones you’ve seen so far. 
So read the whole thing before you get started, and 
give yourself a little time. And don’t worry if you get 
stuck—there’s nothing new in here, so you can move 
on in the book and. come back to the lab later. 


We’ve filled, in a few design details for you, and. we’ve 
made sure you’ve got all the pieces you need...and 
nothing else. 


It’s up to you to finish the job. You can download an 
executable for this lab from the website, and. you can 
download the graphics files we used, in our solution... 


but we won’t give you code for a solution. 



But o-t^cv vcadcvs v^avc dlaimcd 栎 w bva^.^ by puklis^.^ 
栎咖 solution CodcPIe^ 批 Hub, a”d o 仏饮 tollabo^rat.vc sou^c 

toAt V^ostm^ sites, m tasc you r^ttA a iVm 七! 
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A Day at the Races 


The Spec: Puild a Racetrack Simulator 


Joe, Bob, and A1 love going to the track, but they’re tired of 
losing all their money. They need you to build a simulator 
for them so they can figure out winners before they lay their 
money down. And, if you do a good job, they’ll cut you in 
on their profits. 

Here’s what you’re going to build for them … 



The 昏 uys 


Joe, Bob, and A1 want to bet on a dog race. Joe starts with 50 bucks, 
Bob starts with 75 bucks, and A1 starts with 45 bucks. Before 


each race, they’ll each decide if they want to bet, and how 
much they want to put down. The guys can change their bets 
right up to the start of the race...but once the race starts, all 
bets are final. 


The Petting Parlor 


The betting parlor keeps track of how much cash each 
guy has, and what bet he’s placed. There’s a minimum 
bet of 5 bucks. The parlor only takes one bet per person 
for any one race. 




T 


The parlor checks to make 
sure that the guy who’s betting 
has enough cash to cover his 
bet — so the guys can’t place a 
bet if they don’t have the cash 
to cover the bet. 


Welcome to Curly’s 
Betting Parlor 

Minimum Bet: $5 
One bet at a time 
Got enough cash? 




Welcome to Curly’s 
Betting Parlor 

Minimum Bet: $5 
One bet per person per race 
Got enough cash? 


\r 


v 













































A Day at the Races 


Petting 


Every bet is double-or-nothing — either the winner doubles 
his money，or he loses what he bet. There’s a minimum 
bet of 5 bucks, and each guy can bet up to 15 bucks on a 
single dog. If the dog wins, the bettor ends up with twice 
the amount that he bets (after the race is complete). If he 
loses, that amount disappears from his pile. 


Say a pla( 

{}\t tv\A o\ 


\US d jlo bet a-t y/'mdoy/. hi 
4-V^C do<\ W\v\s } \\\s 

; 二 ^ /lo (b 似 —… T 如。吵 f 

Ke bei flus Ke jcls flO move — 娜 1 士 

k loses, his CBs\\ ^ocs dovm by flO. 


A 


The Race 

There are four dogs that run on a straight track. The 
winner of the race is the first dog to cross the finish line. 
The race is totally random, there are no handicaps or 
odds, and a dog isn’t more likely to win his next race 
based on his past performance. 


All bets: double-or-nothing 
Minimum bet: $5 
Up to $15 per dog 
Win: $$ added 
Lose: $$ removed 









Sound fun? We’ve got more details coming up. 












A Day at the Races 


You'll weed three classes and a form 

You’ll build three main classes in the project, as well as a GUI for 
the simulator. You should have an array of three Guy objects to 
keep track of the three guys and their winnings, and an array of 
four Greyhound objects that actually run the race. Also, each 
instance of Guy should have its own Bet object that keeps track 
of his bet and pays out (or takes back) cash at the end of the race. 


You’ll need to add 

using System.Windows.Forms; 

to the top of the Greyhound and 
Guy classes. You’ll also need to add 
the public keyword in front of 
each of your class declarations. 


give, you the skeleU the dass you 
於 ed 匕 build. /。广 job is idilU ^ methods. 


We’ve gotten you started with class descriptions and some 
snippets of code to work from. You’ve got to finish everything up. 

Make sure you add puklit *to 

dlass a^la^atior,. public Class Greyhound { 

public int StartingPosition ； // Where my PictureBox starts 

public int RacetrackLength; // How long the racetrack is 
public PictureBox MyPictureBox = null; // My PictureBox object 
public int Location = 0 ; // My Location on the racetrack 


Greyhound 


StartingPosition 

RacetrackLength 

MyPictureBox 

Location 

Randomizer 



public Random Random^.zer ; // An instance of Random 

y\tcd oy\c o-f Random—ca 


aomizer ； 
^ Y^ u ly 


same K 


3y\dovm object 




public bool Run() { I 、。 哪洲 should fomi io the 

// Move forward either 1, 2, 3 or 4 spaces at random 
// Update the position of my PictureBox on the form like this : 

// MyPictureBox.Left 二 StartingPosition + Location; 

// Return true if 工 won the race ; 

} VC added "to jive 

you ah idea wha 七 "to do. 
public void TakeStartingPosition() { 

// Reset my location to 0 and my PictureBox to starting position 

. Do/ 七 ovc\rthmk 七 his... 
sometimes you just r\ttd *to sc*t 
*bwo -fields, a 灼 d youVc do 灼 c. 


Initialize your arrays of Greyhound and 备 uy objects 


/ — This wovks jus-t like 

£ UbclBouh^v -： -the 


The Greyhound class keeps track of its position on the racetrack during the race, and 
it updates the location of the PictureBox representing the dog to move down the race 
track. Each instance of Greyhound uses a field called MyPictureBox to reference ^ 

the PictureBox control on the form that shows the picture of the dog. It also needs to 5 *to 

know its starting position and the length of the racetrack, which it can determine using the ^ 1 ^ u,rc *^ ox "tnc 

PictureBox for the racetrack (we named it racetrackPictureBox). Here’s the object ^ c / nouh ^ object ； whi^K 

initializer for one of the Greyhound objects in the array (we called it GreyhoundArray): its Lcrt pv-opcir-ty 

to mdkc i*t move. 

GreyhoundArray[0] = new Greyhound() { 

MyPictureBox = pictureBoxl f ^ IS qv-cyhou^d object ^ohtv-ols pi^-( ： u\rcBo>c/. 

StartingPosition = pictureBoxl.Left, 

RacetrackLength = racetrackPictureBox.Width - pictureBoxl•Width, 

Randomizer = MyRandomizer You’ll 的 eed *bo do -this -Pov- objc 乙七 m av-\ray of 

} ； Youll also bo you\r 与 uy objects- Do/ 七 *bo 

srt cadh juy^s MyRadioBu*t"bo^ MyLabcl bo *thc ^o^*tvol| 
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Guy 

Name 


MyBet 


Cash 


MyRadioButton 


MyLabel 


UpdateLabels() 


PlaceBet() 


ClearBet() 


CollectQ 



*bV^c 


r\ Y ou m ' 

vou set 


tti, W'akc 

suve 70 ^ sex >*b 

<f，eW *to 你 11 ， a”d 乙 all 

•如 UfdatcLabcUO 
mC-t^od as soov^ as »t s 
•mVbahz^d. 


This is 



public class Guy { 

public string Name ； // The guy's name 

public Bet MyBet; // An instance of Bet that has his bet 
public int Cash; // How much cash he has 

This y/o\rks c^attly like the MyLabd -field 

ih LabclBouhtcv- -rv-orw Chaptev* 午 . 

// The last two fields are the guy's GUI controls on the form 

public RadioButton MyRadioButton; // My RadioButton 
public Label My Label; //My Label vou sc*t MvLakcl *to ov\t o^c 七 he 

V labels o, W, ^\\ be able 

^ label's it%i us»^ MyLabclT^t. The 

public void UpdateLabels () { same *fov* M'/Rad | oButtor\’ 

// Set my label to my bet's description, and the label on my 
// radio button to show my cash ("Joe has 43 bucks") 

} Add youv- Code hcvc. 

public void ClearBet () { '} / / Reset my bet so it's zero 


^ — ' Rcmcmbcv- 

"that bets dire 


public bool PlaceBet (int BetAmount, int DogToWin) 

// Place a new bet and store it in my bet field 
// Return true if the guy had enough money to bet ^cpv-cschicd by 

} i^-bh^cs o( Bci 


. public void Collect (int Winner) { 

cic object *tn5x // Ask my bet to pay out, clear my bet, and update my labels 

ry USCS ^ The key is b> use the Bet 

object... lei it do the wov-k. 

Tk object -fov dti VAsi 

sets 3 州 0*^ 七， do^ 3^d bc"txoV". 


bets i h the appli^atioh. 


Bet 


Amount 
Dog 
Bettor 



GetDescription 

PayOut 


public class Bet { 

public int Amount; // The amount of cash that was bet 
public int Dog ； // The number of the dog the bet is on 
public Guy Bettor ； // The guy who placed the bet 

public string GetDescription () { 

// Return a string that says who placed the bet, how much 
// cash was bet, and which dog he bet on ("Joe bets 8 on 
// dog #4"). If the amount is zero, no bet was placed 
// ("Joe hasn't placed a bet "). 卜 


you’ll ihstahtiatc Bet 
•m -the ^uy Code ^uy will 
use the this keywov-d -fco 
pass a "to liirnscl-f 

"to "the ihi-tialiicv. 


public int PayOut (int Winner) 




// The parameter is the winner of the race. If the dog won, 

// return the amount bet. Otherwise, return the negative of 
// the amount bet. 

Remember: the form keeps the dogs in an array that starts 
at index 0. Dog #1 is at index 0, dog #2 is at index 1, etc. 
You’ll need to add 1 to the array index to get the winner. 
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Here's your application architecture 

Spend some time looking closely at the architecture. It 
looks pretty complicated at first, but there’s nothing here 
you don’t know. Your job is to recreate this architecture 
yourself, starting with the Greyhound and Guy arrays in 
your main form. 


The -Po\rrw heeds -fco mitializjC 
both of these a\rv-ays wheh 
it stav-ts up. 


TV^C ^ scs ^ po<x 

a : of 二 — 

:二一 a ' 

^VC^OVA^d 山 ss . 


^Q 1 Q 1 


O \ 1 l 

Array of Greyhound references 


will be 


Ar^ohg -the Visual objects 
*Pou\r Pid*tu\rcBox doh*t\rols -ror 
ik pid-tu\rcs O-P -the dogs, /oull 
pass "to them -to -the 

i^itialiws the -fou^ 
^ircyhouhd objects, l-tll also have 
"thvee RadioBut-fcoh doh"t\rols 3hd 
"thvee labels, v/liidh youll pass -to 
"the object ihi-tializ^v-s -the 
备 u y obj 比 *ts. 


ninin 

0 I \ z 

Array of Gu^\references 


Th r ^ uys ^o^ihs 

{o , 

^ E^h of those 
^ has d -field 

6 f d 學 “kh is a 


If your code won’t build because of an error message about 
“inconsistent accessibility,” make sure you added public to the beginning of 
the three class declarations. (You’ll learn more about this later on in the book.) 
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Whew a ^uy places a bet he 
creates a new Pet object 


P»VS*t -t^c -fov-w -tells ^uY ^2- 
•bo fUc a be 七 “ 1 Wtks 。於 

(jio^ 养 3 … 

Guy[1]•PlaceBet(7, 3) 








a^d 


MyBet = new Bet() 
{ Amount = 7 , Dog 


3, Bettor = this 



Forc^ 







return true 


The form uses a Timer to keep the dogs 
running until there 7 s a winner 


•vv -tv^c usev 
七 elU 七 V^C ^ov-w *to 
S'tsvt "tV^C 
*tV^C *fov-w s*t3v-*ts 

s*tav-U *tV^c doy. 


&七从 c T^cv- objects 
tabled ^trbj -to A-aU 
av\d use »*b and 

£*to^0 wc*t^ods *to start 

ay\d cv>d *t^c v-a^c- 



GvjpJ" Be、' 

the 与 uy had chough 晰 y h> y\au the bci 
一 j u Pdatcs the (^uy s labels ahd v-cluv-hs lv-uc. 0-f he 

didh *c have Chough, it would \rctu\rh -false ihS-tcold ) 


hould SV) as SOOh as •，七 ^eWhs Tvuc. 


s 


private void timerl 一 Tick (. . .) i 
for ( loop through each dog ) { 

if ( call the dog’s Run() method ) 
we have a minner! 
call timerl .Stop () to stop the dogs 
show a message saying who zvon 
each Guy collects his winnings 


System ANV^o 


The Pet object figures out if it 
should pay out 



The bettmj pavlov- ir> -the -Pov-m -tells 
cadli 今 uy y/hidh dog y/oh so he ddh 
to\\tt{, 3r>y y/ihh'm^s -Pvom his bet 




Guy[1].Collect(winningDog) 

- ^ 


MyBet.PayOut(winningDog) 




Poh ； t -Pov-gct "to 

add / -to the av-vay 

io -fihd the 

wihhihg dog/ 


Fov^ v 

TV>c ^uy Will add i\\t wul 七 of BciPayoutO -to 
Wis dasV^. AH micir^c^c *»s *m *tKc BctPayouiO 
mc-tKod ： i-f do^ ’I 七 re 七 uv^s /W 。 ⑽七；、一 " 

o*tKcv-y/*isc, *i*t VC*tuvv\s 



if ( my dog won ) { 

return Amount; 

} else { 

return -Amount; 
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Here's what your ftUl should look like 


Play with the Timev* objedV 

•to the speed o( the 


s l^tcv-val f\rofC\rty 

race- 


The graphical user interface for the “Day at the Races’’ application 
consists of a form that’s divided into two sections. The top is the 
racetrack: a PictureBox control for the track, and four more for 
the dogs. The bottom half of the form shows the betting parlor, where 
three guys Joe, Bob, and Al) can bet on the outcome of the race. 

,, r j 心 ovm PidWcBo% 6o^ol ^ 

of r objects, tat\\ o^c s 

7 ou of ^ ^ Fo^Bo^de^yle 

’ 丄 k 如 以如卞 ―“ to FixedSi^le a,d 

tX ⑽二 4 一，♦秦 ^ it — 


t f id t h 啊吻 J- 

Pi 〜 Box Co^ol ^ sci 

i^i, usc ^ 化咐。 

;t WOh hf ； '9^li.k o, it a,d 

Lr 】it ^ ^ " akc su " c ^ 

beUd — Pi 〜 Box 乙。士土 
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Flip badk *to *thc c^d o( Chap*tcv- Z *to \rcm*md 

youvsel-p hoy/ jo load By\ irv\d^e *m*to d Pid*tu\rcBo^. 




Sei the SiicModc pvopeviy to S-t\rc*UhUajc so you cby\ vcsi^c 
the PidiuireBox. a^d have ihe ima^e sjve-Uh -to -Pill i-t up. 


^ should this label with the — 你 beUsi 叫七 he 

P^ty of the H^\tU ? Vo^ CoM ^ the bet 如 ⑽ t 



Betting Parlor 

minimumBetLabel 

ioeRadioButton 
)obRadioButton 
alRadioButton 



Bets 


ioeBetLabel ) 

bobBetLabeL 


alBetLabel 



name 


Bets 


5 C bucks on dog number 1 



1/\A^ a ^uy glades a bet, it ovcv>wv'i*tcs 
a^y py-evious bc*t V^c pladcd- Ti^c tuvve^'t 
be*ts sIioy/ iy\ "tiicsc label doyvbrols. 
tadii label Kas A'A'toSiz^ set *to False 
dr\d Bovdcv-S-tylc set to pi%edS’m 咖 



il! 仏 ; ^ yy s 十卜七咖忪⑽ ,but 
theire s ohly ©he bettihg window so ohlv 

lT ?laU 9 bct ai a t，mc * These 

Jr!° i U L L / USC< ? scl ^t a u y 

You can ctownloact tke grapkics files from www.keactfirstlats.com/ljoolis/Wcsliarp/. 


Out all kc*ts avc 
fUcd, t\\tV *tW»s 
ku*b*to^ *t° s*t3v-*t 
*bV\c v-a6c. 
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Placing bets 


ZjC 


Use the controls in the Betting Parlor GroupBox to place 
each guy’s bet. There are three distinct stages here: 


o 



V^u II r\tt& 3 loop -fco m’rtiali 
eadh ^uy object by dalli^ his 
Clcol\rBc*tO rwc*thod (v/hidh 
has hirw pladc 3 be 七 V/i 七 h 
2 ^\ro budks) ar>d "then 

his UpdaicLabdsO mcihod. 


No bets have been placed yet. 

When the program first starts up, or if^a race has just 
finished, no bets have been placed in the betting parlor. 
You’ll see each guy’s total cash next to his name on the left. 




sV^OY/S \aY hcvc. 


Mnimum bet:(^buda1 :: ' | ll m 
(•) Joe has 50 bucks 
O Bob hasj^ixjcks 
Al has 45 bucks 


Bets 



bc*t 


Joe hasn\ placed a bet 

T 

Bob hasn\ placed a bet 1 


Al hasnl placed a bet 


Joe Bets 5 buck^ on dog number 


▲ 

▼ 


❺ 


Ti^C mmimunr' bc*t should be 
same ds *thc ATmimum value m 
*thc NumcvidUfPow^ dorrbrol. 

Each guy places his bets. 

To place a bet, select the guy’s radio button, select an amount and a dog, and click 
the Bets button. His PlaceBet () method will update the label and radio button. 

Bets 


0y\tt Bob places 
his bet, his 与 uy 
object upda-tes -this 
l^bcl av\d the vadio 
birttoh -text. 


Mini mum bet: 5 bucks 

Joe has 50 bucks 

• Bob has 75 bucks 
O Al hasH 1 ^ 


Joe hasnt placed a bet 



Bob bets 13 on dog #3 



Al hasnt placed a bet 


Bets 13 : bucks on dog number 3 

^ 撕 rA'i: 

❾ After the race, each guy collects his winnings (or pays up!). Wb a 代 double 省 - ^ 

Once the race is complete and there’s a winner, each Guy object calls his S o ^ 

Collect () method and adds his winnings or losses to his cash. yybtc 於 an J 

Minimum bet: 5 


We have a winner 


*s to h 

D 






Joe has 5 □ bucks 
Bob has 62 buc^s 
Al has 45 bucks 



^lakc sumc all -the ⑽ d objects shave or>c Random objed/ K tacM doj Scales i-b o( 

Random, you mi 吵七 see a bug y/hc^-c all o( 七 he dio^s gchcvatc ▲ 


the sanr»c sc^uc^dc ird^diom ^umbeys. 
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The Finished Product 

You’ll know your “Day at the Races’’ application is 
done when your guys can place their bets and watch 
the dogs race. 


A Day at the Races 


puvma vatc, W do 5 
across -bV^c 




You can ctownloact a finiskect executable ， 
as well as tke grapkics files lor tke lour 
ctogs and tke racetrack ，irom tke Head 
First laLs wetsite ： 


www.keactiirstlats.coni/tooks/liicslia 



A 


Du ,„ 9 the ,au ： ,o bets be ? \aud...a,d .ake 
—you daht sta^r-t a ^ while tk doas ave 

,'ll Y °\^ Ad disable the ^oupBox 
by scih^ .ts Enabled p^^ty to 仏 e 


SUV-C 

V"Uhhi 


We didn’t give solutions for this lab 
because when programs get large enough, 
there are too many ways to build them for 
us to say there’s one “right” solution. But 
if you need a hint, plenty of people have 
claimed their bragging rights by publishing 
their own code on CodePlex.com and other 
collaborative source code hosting sites. 





































5 encapsulation 


肴 

Keep your privates". + 

# private 



Ever wished for a little more privacy? 

Sometimes your objects feel the same way. Just like you don’t want anybody you 
don’t trust reading your journal or paging through your bank statements, good objects 
don’t let other objects go poking around their fields. In this chapter, you’re going to 
learn about the power of encapsulation. You’ll make your object’s data private, 
and add methods to protect how that data is accessed. 


this is a new chapter 













kathleen needs your help 


Kathleen is an evewt planner 




v/ould v-at^cv s)j>cv\ 

一 七叫 events, not 
?lavm 叫 estimates. 


She’s been planning dinner parties for 
her clients and she’s doing really well. 
But lately she’s been having a hard time 
responding to clients fast enough with an 
estimate for her services. 


When a new client calls Kathleen to do a party, she needs to find 
out the number of guests, what kind of drinks to serve, and what 
decorations she should buy. Then she uses a pretty complicated 
calculation to figure out the total cost, based on a flow chart she’s 
been using for years. The bad news is that it takes her a long time 
to work through her chart, and while she’s estimating, her potential 
clients are checking out other event planners. 

It’s up to you to build her a G#-driven event estimator and save 
her business. Imagine the party she’ll throw you when you succeed! 
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What does the estimator do? 

Kathleen runs down some of the basics of her system 
for figuring out the costs of an event. Here’s part of 
what she came up with: 


Kathleens Panfu Planning PnognarD-Cost Estimate fora Dinner ?q±y 


參 


參 


# 


Pop each person on the goesf list there's a $25 food change. 

Clients have a choice when if comes to drinks. Most panties serve alcohol, which 
costs $20 per person. Bof they can also choose to have a party wit hoof alcohol. 
Kathleen calls that the “Heal% Op 十 ion;，and i 十 only costs $5 per person to have 
soda and juice instead of alcohol. Choosing the Healthy Opt ion is a lot easier Von 
hen, so she gives the client a 5% discoonf on the entire party, too. 

There are two opt ions for the cost of deconaf ions. If a client goes with the 
normal decorations, its ^7.50 pen person with a ^ 30 deconaf ing fee. A client can 
also opgnade the party deconaf ions to the Taney Decorations -that costs 
per person with a $50 one - 十 ime decora 十 ing fee. 


Here’s another look at this same set of costs, broken 
down into a little flow chart to help you see how it works: 


Some o-p these ^hoidcs involve 

a -to the -Pihal pv-i^c o( 

tk cveh-t, as well as individual 
fC\r-pC\rsoh dosts- 


Number of 

i | 

Healthy 1 

people, 
food ( 令 25 


Option? t 

per person) 

1 1 

1 


Fawcy 

decorations 
(M 5 per person 
+ 令 50 decorating 
fee) 



l/Vhile rwost dhoidcs the 

^os*t -fo\r aucs-t, thcv-c avc 
also OhC-tirhC +CCS -to ir 


you are here ► 
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how you'll solve kathleen's problem 


You’re going to build a program for Kathleen 

When you flip the page, you’ll see an exercise to build a dinner party-planning 
program for Kathleen. Here’s a sneak preview of what you’ll build. 

You'll build this form, which Kathleen will 
use to set the options for her party. She'll set the 

number of people and check or uncheck the boxes for fancy 
decorations or a healthy option. As she does, the cost at the 
bottom will change based on her selections. 


Q ? Party Planner 



Number of People 


1G 


[^1 Fancy Decorations 
1 Healthy Option 


Cost $575.00 


DinnerParty 


NumberOfPeople 

CostOfBeveragesPerPerson 

CostOfDecorations 


SetHealthyOptionQ 

CalculateCostOfDecorations() 

CalculateCost() 


The logic for the program will 
be built into a class called 
DinnerParty. The form will create a 
DinnerParty object, store a reference to that 
object in a field, and use its fields and methods 
to perform the calculation. 


Here'S what the top Of public partial class Forml : Form 

the form will look like. It 、 

Will have a field Called DinnerParty dinnerparty; 


dinnerparty to do the cost 

calculation. The first thing 
the form will do is set it up with 
default values, and then calculate 
the cost using a method called 
DisplayDinnerPartyCost(). 
The form will call that method every 
time the user changes an option. 


public Forml() 

{ 

工 nitializeComponent(); 

dinnerParty = new DinnerParty() { NumberOfPeople 

dinnerParty.SetHealthyOption(false); 
dinnerParty.CalculateCostOfDecorations (true); 
DisplayDinnerPartyCost(); 
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Here's how the Dinnerparty class will work. The current state of the 
Dinnerparty object — the values stored in its fields — determines how it does 
its COSt calculation. Setting the healthy option, choosing fancy decorations, and adding or 
removing people changes the state of the object, which causes the CalculateCost () method to 
return a different number. 


You'll use a NumericUpDown 
control to set the number of people 
by having its event handler set a 
field in the Dinnerparty object. 


If the user checked 
the "Fancy Decorations" 
box, the form will pass the 
CalculateCostOfDecorations() 
method true for its fancy parameter. 


Number of 
people. 

Food [^25 
\ per person) 

V ■一一 _ ■ 



Juice and soda 
( 令 5 per person 
5 文 discount o 
total cost) 



Fawcy 

decorations 
(M5per person 
+ 令 50 decorating 
fee) 


Alcohol 


Normal \ 

decorations I 

( 令 20 per 

K 

[^ 7.50 per 1 

person) 

V — — 1 


person 衫 30 | 

1 \ 

L decorating fec)| 


The cost of food per person is 
always $25. You'll learn about 
howto use a constant to store 
a value that never changes. 


When the user clicks 
the Healthy Option 
checkbox, the form 
calls a method called 
SetHealthyOption() 
that changes the way the 
total cost is calculated. 


The beverages cost 
less if the user chooses 
the healthy option. The 
SetHealthyOption() 
method updates a field called 
CostOfBeveragesPerPerson 
to keep track of how much the 
beverages cost. 


Every time the user checks a box or changes the number of people, the 
event handler methods use the Dinnerparty object's fields and methods 
to update its state. Then they call the CalculateCost () method to come 
up with a final cost for the party and display it in the label. 


(jot all L©t T s start bmldfng! 

you are here 
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ok, no problem 


We're going to start asking you to solve longer and tougher problems 



Build a program to solve Kathleen’s party estimating problem. 




O 


DinnerParty 


NumberOfPeople 

CostOfBeveragesPerPerson 

CostOfDecorations 


SetHealthyOptionQ 

CalculateCostOfDecorations() 

CalculateCostQ 


o 


❺ 


你 ㈣ 
⑽ aU . 


Create a new Windows Forms Application project, add a class file to it called DinnerParty. 
cs, and build the DinnerParty class using the class diagram to the left. It’s got three 
methods: CalculateCostOf Decorations (), SetHealthyOption (), and 
CalculateCost () . For the fields, use decimal for the two costs, and an int for 
the number of people. Make sure you add an M after every literal you assign to a 
decimal value (10 • 0M). 

Here’s a useful G# tool. Since the cost of food won’t be changed by the program, 
you can declare it as a constant, which is like a variable except that its value can 
never be changed. Here’s the declaration to use: 

public const int CostOfFoodPerPerson = 25; 

Flip back to the previous page to be sure you’ve got the calculations right for 
the methods. Only one of them returns a value (a decimal) — the other two 
are void. The CalculateCostOf Decorations () method figures out 
the cost of decorations for the number of people attending the party. Use the 
CalculateCost () method to figure out the total cost by adding the cost of 
the decorations to the cost of drinks and food per person. If the client wants the 
healthy option, you can apply the discount inside the CalculateCost () method 
after you’ve figured out the total cost. 


o 


Add this code to your form: 

DinnerParty dinnerparty; 

public Forml() { 

InitializeComponent() 


dedare di^cvPavty m 
七 and add these W I’mes 

beloy/ I 於 rtializjcCo 州 fo 竹⑼七 ()• 


他拼 4 咐。 h0 

^. SC . S a ^°°l 丄 ii 丄 l 丄 d 丄丄 zeuumpuiieiiL 

j cw^ptioh) -to upd^i Ii ^ dinnerparty = new DinnerParty () { NumberOfPeople 

Cos-t^)-fy CVcV( . a p ^ c - ^dinnerparty. SetHealthyOption (false); 


= 5 }; 


dinnerparty.CalculateCostOfDecorations(true) 
DisplayDinnerPartyCost(); 


o 


The dhcdkbo>ccs a\rc 

healthyBo 乂 . You dan keep 

the dc-r3ul*t -Pov 七 he 
H unr»c\ridUpPoy/^ dojrrbrol. 


Here’s what the form 
should look like. Use the 
NumericUpDown control’s 
properties to set the maximum 
number of people to 20, the 
minimum to 1, and the default 
to 5. Get rid of the maximize 
and minimize buttons, too. 


Se 七七 he dc-Paul*t 
value *to *7. The 
mmimum should be 
I dir>d maximum 
should be 2-0- 

Sci ihc Fa^dy ^ 

Dcdo\ra-tio^s f 
dhcdkbo^s Checked 
f\ropc\rty -fco Tv-uc- 


口？ Party Planner 

Number of People 


5 


: 


[^1 Fancy Decorations 
Healthy Decorations 


Cost 


This is a label earned dos 七 Label. The Tt%i P\rofc\rty is cmfty, -the Bo\rdc\r£*tylc 
f\rofc\rty Sti io a^d -the Au*to£i« frofeirty sti {o -false. 
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kr 


because we know you're up to the challenge! 


The y>al is *to Kelp you become a yca-t 
C 养 ^VO^V'dw'W'CV "； 3i^d ^ui^kes't v/3y 
七 ha 七 ^odl is solvmj pvoblc^s like "tKis one* 


encapsulation 


o 

丁 w»s method W»'l 

tailed V>7 all o\ 

the o-tV^cv methods 
>you tvca-tc or\ tV\C 

tovm. l-t's 70 U 

update t^c 6ost { 

label yj decimal Cost = 

w^luc y/V\c^c^cv / costLabe 1 • Text 

av>V*tWm^ Aa 呼 s . } 

Charge xht r>amc oA* tnC 

label 七 ha 七 displays *thc dos*t 

*to dos*tLabcl- 


Instead of using a button to calculate the costs, this form will update the cost label 
automatically as soon as you use a checkbox or the NumericUpDown control. The first 
thing you need to do is create a method in the form that displays the cost. 

Add this method to the Forml class. It’ll get called when the NumericUpDown control is clicked: 

Add this rwethod to the -fov-rw—i-tll 

private void DisplayDinnerPartyCost () m^Cosf 


dinnerParty. CalculateCost (checkBox2 . Checked), 
=Cost.ToString("c"); 


Rassiha K C l -fco ToS-tv-ihgO tells 
it "to fo\rr^t tk dost as a 

^u\r\TChdy value, l-f youVc ih a 

that uses dollar itll 
add d jolla\r sigh. 


This is -tv-uc i-f -the 
thcdkbo^ (or -the ttcalihy 
Option is cMtcktd- 


Y 0[a v c bcch usih 0 
CVCht hdhdlcirs 
all dloh0 一 wKch 
you double- 匕 |i 匕 k 
Oh 占 bu-fc-fcoh, 
the IDB adds 
a Cli 匕 k cvcht 
hahdlcv. "ow 
you khow what 
its 匕 ailed. 


o 


Now hook up the NumericUpDown field to the NumberOf People variable you 
created in the DinnerParty class and display the cost in the form. Double-click on 
the NumericUpDown control — the IDE will add an event handler method that 
gets run every time the value in the control is changed. Use this method to reset the 
number of people in the party. Here’s the code for the method: 

private void numericUpDownl_ValueChanged( 

object sender, EventArgs e) 


dinnerParty.NumberOfPeople 
DisplayDinnerPartyCost(); 


(int) numericUpDownl.Value; 

You Y\ttd bo ^as*t ^umCV-idUfPov/^ValuC *to 

av\ mi because its a Pcdimal fv-ofc\rty. 



Uh oh — there’s a problem with 
this code. Can you spot it? Don’t 
worry if you don’t see it just yet. 


The value you ser\d -fvom -fovm -to 

Will be Tha 七 v/ill 

be pdssecl as a boolc3i^ *to 七 he 

mcihod m *bKc tlass. 


These 



成 ss ㈣ 

W，11 dis P ,a y {oia\ Cosioy^i^t" 冰 0 hd 


rov-rn. 



o Double-click on thdfFancy Decorations^pheckbox on the form and make 
sure that it first calls CalculateCostOf Decorations () and then 
DisplayDinnerPartyCost () . Next, double-click the Wealthy Option^ 
checkbox and make sure that it calls the SetHealthyOption () method in the 
DinnerParty class and then calls the DisplayDinnerPartyCost () method. 
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exercise solution 



Here’s the code that goes into DinnerParty.es. 

_ Usm 5 a U Cosi0^ooA?tr?t^ 

J{Utl§(S 厂 ensuves i\\t value be I*t also 

/ m akcs i\\t todt casicv -to read—tlcav tV>at 

/ i\\\s value r\cvcv- diia^jcs. 

class Dinnerparty { \ the ^ates 

public const int CostOfFoodPerPerson = 25; 

public int NumberOfPeople / 
public decimal Cost Of Beverages Per Persona- 
public decimal CostOfDecorations = 0; 



the 
to 


- object; i*t uses "the ihiti^liz^V" 

set /Vurwbc\rO-fPcoplc. Thch 


it alls SctHcal-thyOp-tiohO 

C^kulatcCostO-PDc^ov-a-tiohsO -fco 
set the othev* -fields. 

public void SetHealthyOption(bool healthyOption) { 
if (healthyOption) { 

CostOfBeveragesPerPerson = 5.00M; 

} else { Wc used w i-f (Far\dv) w ms-tcad 

CostOfBeveragesPerPerson = 20.00M; ^ u .^ ^ bcdausc 

} ^ siait^i always cMtcVs i-f i\\t 

} ^or\di*tior\ is *tv"uc- 



public void CalculateCostOfDecorations(bool fancy) 
if (fancy) 

{ 

CostOfDecorations = (NumberOfPeople * 15.00M) + 50M; 
} else { 

CostOfDecorations = (NumberOfPeople * 7.50M) + 30M; 

} 

} 

public decimal CalculateCost(bool healthyOption) { 
decimal totalCost = CostOfDecorations + 

((CostOfBeveragesPerPerson + CostOfFoodPerPerson) 
* NumberOfPeople) / 


if (healthyOption) { 

return totalCost * .95M, 
} else { 

return totalCost; 

} 



Wc used pa\rc^*thcscs -to make suv-c -the 
math y/ov-ks out pv-ofC\rly. 



This applies *thc *5% disdour>*t *to 
-the ovcv-all cvcr>*t tosi i-P i\\C 
r>o 灼 aldoholid of 七 ion was diiosc^. 


^ ou Ao ^ ^cd -to add Vmj System.IdoY/s.Pows/’ *to y 败 Di^cvPavty class, because 
I 七 docs^ -t use /WcssajcBo^-Shoy/O o\r any 七 hi% else ihai -NET Fv-a^cv/ov-k namespa 匕 e. 
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We had you use a decimal for the prices because it’s designed for monetary values. Just make 
sure you always put an “M” after every literal — so if you want to store $35.26, make sure you 
write 35.26M. You can remember this because the M stands for Money \ 

^ CM DisplayP*m^c\rPa\rtyCos-t ho 

public partial class Forml : Form { the label shows the 

Dinnerparty dinnerParty; / 匕從七 as so 咖舡七 he loaded, 

public Forml() { 

InitializeComponent(); 
dinnerParty = new DinnerParty() { NumberOfPeople = 5 }; 

dinnerParty.CalculateCostOfDecorations(fancyBox.Checked); 

dinnerParty. SetHealthyOption (healthyBox. Checked),; . ,, ,. o , 

rn n n ^ M Charts to iht dhcdkbo^cs the Wm set 

DisplayDinnerPartyCost () ; ^ , . r- . . 丄 

. iht hcal*tKyOf*tior> a^d ra^dy boolean to 

} *tvuc ov- -false *m -the Sc*tHcal*thyOftio^O a^d 

Cal^ula*tcCos*tO-PPcdov-a*tior>s() methods. 

private void fancyBox_CheckedChanged(object sender, EventArgs e) { 
dinnerParty.CalculateCostOfDecorations(fancyBox.Checked); 
DisplayDinnerPartyCost () ; ou\r checkboxes 

} ad so you dould see whats 

jo'mj o\r\ ih tlici\r cvchi handler methods. 

private void healthyBox_CheckedChanged(object sender, EventArgs e) { 
dinnerParty.SetHealthyOption(healthyBox.Checked); 

DisplayDinnerPartyCost(); 

} 

private void numericUpDownl_ValueChanged(obj ect sender, EventArgs e) { 
dinnerParty.NumberOfPeople = (int)numericUpDownl.Value; 

DisplayDinnerPartyCost () ; ^ - ^ d.mw fav-*ty dost r^ccds *fco be 

} - 厂 v-cdaldula*tcd a^d displayed -time i\\t ^umbev- 

ov *thc dV>cdkbo%cs art thedked- 

private void DisplayDinnerPartyCost() { 

decimal Cost = dinnerParty.CalculateCost(healthyBox.Checked); 
costLabel. Text = Cost. ToString ( f, c f, ); 




^ ouvc how you w ahy objed io a sVmg usmg its ToSVmgO method. 

you pass 、 "to ToSVmgO, \i dohvc\rb it io the lodal 匕 umhdy. /ou da” also pass iK3 w ^ 
+ovmat i-t as a decimal humbc\r with -three decimal places, W 0 W (that's a z«ro) -to dohve^t \i io 
a whole hu 州 bc\o KK 0V a wUc h_b^r perwtay, ahd\" *to display i-t as a _bcr with a 

W thousahds. Take a mihu-tc a^d s CC how each these looks your poyarJ 
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something^ gone terribly wrong 


Kathleens test drive 



o 


THIS IS SO COOUl 
6STIMATIN& IS ABOUT 
TO A UOT 

BASIBR. 


RoWs o^c ^a-t^lccv^s 

W 心 SV^c M Ws 

^ddm^ last 7cav, 办 d::: 
?arb/ 


d'm^cv 


Rob (on phone): Hi, Kathleen. How are the arrangements 
for my dinner party going? 

Kathleen: Just great. We were out looking at decorations this 
morning and I think you’ll love the way the party’s going to 
look. 

Rob: That’s awesome. Listen, we just got a call from my wife’s 
aunt. She and her husband are going to be visiting for the next 
couple of weeks. Gan you tell me what it does to the estimate 
to move from 10 to 12 people on the guest list? 

Kathleen: Sure! I’ll have that for you in just one minute. 


W\\cy\ you stay 七 -the 
pvoyarw, 七 he Fa^dy 
Dcdo\ratiohS box. should 
alv-cady be cMtcVtA 
because you set its 
Checked pv-opc\rty 
"to *bruc. Srttmj *thc 
^urwbcv people {jo 10 
Jives a dos-t o-P 


iVe -took this s^reensho 七 m 
■the U^i-tcd S-ta-tcs, So wc saw 

d dolldr si^h. I-P youVc *m 七 he 

U^i-tcd ^*mjdorw ; F\rdv)C，c, ov- 
Japa 〜 youll see a s 咖 (or 七 he 

pound, cuvo, o\r ycY\ because 

youVc usrnj ToS-t^m^OVO -to 
to^vcv-t 七 he dermal ^osi -to a 

tu\rre 灼匕 y s-tv-mj. 




口 ？ Party Planner 


Number of People 



12 | 


: 


[^1 Fancy Decorations 
]Healthy Option 


Coat $G65.0G 


Clidh^ih^ "tlic Kumbc\r o-p 
People value -f\rom lO -fco IZ 
hittihj Ch*tc\r shows 
as "the "toicll dos*t- lirwrw, that 


sccrws a little low.”. 


Kathleen: OK. It looks like the total cost for the dinner will 
go from #575 to S665. 

Rob: Only #90 difference? That sounds like a great deal! What 
if we decide to cut the fancy decorations? What’s the cost then? 
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7u^ ih9 ^ F 

^e^box dy 

tl i^ CS ^^ouh-t by f%. 

That t be H 3 hi/ ’ 


° J Party Planner 



Number of People 


12 


: 


I I Fancy Decorations 
]Healthy Option 


Cost $6G0.00 


Kathleen: Um, it looks like...um, S660. 

Rob: S660? I thought the decorations were S15 per person. Did you change your 
pricing or something? If it’s only S5 difference, we might as well go with the fancy 
decorations. I’ve gotta tell you though, this pricing is confusing. 

Kathleen: We just had this new program written to do the estimation for us. 

But it looks like there might be a problem. Just one second while I add the fancy 
decorations back to the bill. 


a 9 Party Planner 

Number of People 
12 : 

M Fancy Decorations 

I I Healthy Option 

Co^ $770.00 



一 u? A 

TV^csc avc just 



Kathleen: Rob, I think there’s been a mistake. It looks like the cost with the fancy 
decorations just shot up to $770. That does seem to make more sense. But I am 
beginning not to trust this application. I’m going to send it back for some bug fixes 
and work up your estimate by hand. Gan I get back to you tomorrow? 

Rob: I am not paying S770 just to add two people to the party. The price you 
quoted me before was a lot more reasonable. I’ll pay you the S665 you quoted me in 
the first place, but I just can’t go higher than that! 





Why do you think the numbers are coming out wrong every time Kathleen makes a change? 
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wasn^ expecting that 

Each option should be calculated iiidividuaHy 

Even though we made sure to calculate all of the amounts according 
to what Kathleen said, we didn’t think about what would happen when 
people made changes to just one of the options on the form. 

When you launch the program, the form sets the number of people to 5 
and Fancy Decorations to true. It leaves Healthy Option unchecked and 
it calculates the cost of the dinner party as S350. Here’s how it comes up 
with the initial total cost: 


o 


Don’t worry! 
This one 
wasn’t your 
fault. 

We built a nasty little bug into the 
code we gave you to show you just 
how easy it is to have problems 
with how objects use one another’s 
fields...andjust how hard those 
problems are to spot. 



5 people. 

^20 per person for drinks - - Total cost of drinks s H00 

令 25 per person for food - > Total cost of food s H25 


^15 per person for decorations 
plus ^50 fee. 


- > Total cost of decorations s ^\25 



口？ Party Planner 



Number of People 


[^1 Fancy Decorations 
I I Healthy Option 

Cd 功 $350.00 


•0 so 





9°od 


When you change the number of guests, the application should 
recalculate the total estimate the same way. But it doesn’t: 


10 people. 

^20 per person for drinks - > Total cost of drinks s ^200 

^25 per person for food -- ^ Total cost of food s ^250 


Party Planner 



Number of People 

^I ： 


令 15 per person for decorations - 々 Total cost of decorations s 令 200 ® Fancy Decorations 


plus ^90 fee. 


Uncheck the Fancy Decorations 
checkbox and then check it again. 

This will cause the DinnerParty object’s 

CostOf Decorations field to be updated, 

and then the correct cost of S650 will show up. 


^00 + ^ 50 + 200^650 


This is ihe h>U 

^ ^ou/d ad 



I I Healthy Option 

$575.00 


Cost 


TKc fvoyam is addm^ old dost o( 
dcdov3tioy>s uf v/i*tK Y\t^i dost ok 
-food dir>d dhrmk. 

Its do'm^ J2O0 + + 

^ -food d^k tLi〆 Old dedovaWs 
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encapsulation 


The Prd^Jetn XJ]> Cl^se 


Take a look at the method that handles changes to the value in the numericUpDown 
control. It sets the value from the field to the Numberof People variable and then 
calls the DisplayDinnerPartyCost () method. Then it counts on that method 
to handle recalculating all the individual new costs. 


private void numericUpDownl 一 ValueChanged( 

object sender, EventArgs e) 


dinnerParty.NumberOfPeople = (int)numericUpDownl.Val 




TWis I'mc va ' uC 

m -tWis mstaw 

p wcvpav 切 如 

value rn ^ 


DisplayDinnerPartyCost (); 



TWis dalls Caldula-tcCostO mc-tKod, bu*t ^ 

-tKc Caltula*tcCos*to^Pcdo\ratior>sO mC*tV>od. 


So, when you make a change to the value in the Numberof People 
field, this method never gets called: 

public void CalculateCostOfDecorations(bool Fancy) { ; 

This vaviablc is sc*t -to fl2^ *fv-om y/Kcir> 

if ( Fancy) { ^ _ _ -fovm -fivs*t ddlled a 灼 d s\v\Ct *tVis mc*tKod 

Aots^i yi dalled *i*t docs^-t 

CostOfDecorations = (NumberOfPeople * 15.00M) + 50M; 


else 


CostOfDecorations = (NumberOfPeople * 7.50M) + 30M; 




TKaVs v/V>Y -tKc y>umbcv torrtch v/Kcir> you *tu\nr> 

Pcdovatio^s badk 。灼 . dKcdkboy. ^^kes 

-tKc fvoyam CaltulatcCostO-f Pcdov-atior>sO a^am- 


This isn’t the only part of the program that has problems, either. The two checkboxes are inconsistent 
in how they behave: one calls a method to set the object’s state, and the other is passed as an argument to a 
' method. A programmer trying to figure out how this program works will find it totally counterintuitive\ 


P*id you Kavc a bi*t 
o( *brouble 
ou 七 \\o\n 

y/ovks? Poy >’ 七 be Kav-d 
youv*scl-f i-f you did- 
I 七 dould be because 
v/c asked you *to build 
a pvo^vam 七 1 ^七 iiad 
*tKcsc doy>dcf*tual 
pvoblcmsf You II 
build a better, 

sirwplcv VCVS*ioir> 3*t 
tv\A o( dKaftcv-. 



Q 


WOU> OMZ 工 ASSUMBD KATHUBBN W^UUD 
ALWAYS SBT AUU THRBB OPTMS AT OUCBl 


People won’t always use your classes in 
exactly the way you expect. 



Luckily, G# gives you a powerful tool to make sure your 
program always works correctly — even when people do 
things you never thought of. It’s called encapsulation 
and it’s a really helpful technique for working with objects. 


•..and sorwctirwcs 
"those “people" who 
3 v*c us*mj you\r classes 
3 v*c you/ Y® u 眯吵七 
be a ^lass 
•today "tha-t you’ll be 
us*mj "tomovvow. 
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protect your objects 


It's easy to accidentally misuse your objects 

Kathleen ran into problems because her form ignored the convenient 
CalculateCostOf Decorations () method that you set up and instead 
went directly to the fields in the DinnerParty class. So even though your 
DinnerParty class worked just fine, the form called it in an unexpected way... 
and that caused problems. 


O ^OVJ THB t>!NN6isP^Ty CLASS BXPBCTBt> TO BE CAUUBl> 

The DinnerParty class gave the form a perfectly good method to calculate the 
total cost of decorations. All it had to do was set the number of people and then call 
CalculateCostOf Decorations (), and then CalculateCost () will return the correct cost. 

NumberOfPeople = 10; 



© THB l>INNe^PA^TY CLASS VJAS ACTUALLYCAUUBt> 

The form set the number of people, but just called the CalculateCost () method without first 
recalculating the cost of the decorations. That threw off the whole calculation, and Kathleen ended 
up giving Rob the wrong price. 



CalculateCost () returns S575 ^tr\ though the -Pov-m didh^t set up 

穴 the pa^y p^ropc^rly, CakulalcCoslO still 

代七 ulr|r ^ a humbcUhd -thcv-c was ho 

way -to khow that the 

^urwbcv- was wv-ohg. 
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Encapsulation means keeping some of 
the data m a class private 


Use 



owh 


D bz.ihess -fco youv- 

it—i-f you love 

。枓七 he V 

dct\avahov\, then c# will 

j us ^ that your (\c\d 
is piriva-tc. 



There’s an easy way to avoid this kind of problem: make sure that there’s only one 
way to use your class. Luckily, G# makes it easy to do that by letting you declare 
some of your fields as private. So far, you’ve only seen public fields. If you’ve 
got an object with a public field, any other object can read or change that field. 

But if you make it a private field, then that field can only be accessed from 
inside that object (or by another object of the same class). 

/\|so, a dlass^s methods C3 iy\ addess 
pv*wa*tc -f ield o*f 七 dass. 

^ y° u >wah-t "to 3 

class Dinnerparty { j/ t 

^ tdls c# tha-t i-f you^vc aoi av\ ih 七 h 以 

private mt numberOfPeople; \h ^idd lv 

be 广 d ahd wiriUch by that i 七 

... ^ ^ - 


•field pv-ivatc ； dll you v\ccd 


public void SetPartyOptions(int people, bool fancy) 


numberOfPeople = people; 

CalculateCostOfDecorations(fancy) 


public int GetNumberOfPeople() 
return numberOfPeople; 


, ㈣㈣ :微 


By making the field that holds the number 
of party guests private, we only give the 
form one way to tell the Dinnerparty class 
how many people are at the party — and 
we can make sure the cost of decorations 
is recalculated properly. When you make 
some data private and then write code to 
use that data, it’s called encapsulation. 


en_cap_su_la_ted ， adj. 

enclosed by a protective coating 

or membrane. The divers were fully 

encapsulated bj) their submersible, 

an ^ could only enter and exit through 
the airlock. 
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spy versus spy 


Use encapsulation to control access to your 
class’s methods and fields 


When you make all of your fields and methods public, any other class 
can access them. Everything your class does and knows about becomes 
an open book for every other class in your program.. .and you just saw 
how that can cause your program to behave in ways you never expected. 
Encapsulation lets you control what you share and what you keep private 
inside your class. Let’s see how this works: 



Super-spy Herb Jones is defending life, liberty, and the pursuit of 
happiness as an undercover agent in the USSR. His ciaAgent object is 
an instance of the SecretAgent class. 



RealName : "Herb Jones" 

Alias : "Dash Martin" 

Password : "the crow flies at midnight" 


SecretAgent 

Alias 

RealName 

Password 


AgentGreetingQ 


❺ 


Agent Jones has a plan to help him evade the enemy KGB agents. He 
added an AgentGreeting () method that takes a password as its 
parameter. If he doesn’t get the right password, he’ll only reveal his 
alias, Dash Martin. 



Seems like a foolproof way to protect the agent’s identity, right? As 
long as the agent object that calls it doesn’t have the right password, 
the agent’s name is safe. 


EnemyAgent 

Borscht 

Vodka 


ContactComrades() 

OverthrowCapitalistsQ 


• m sta^c t 叫七 . 



AgentGreeting ("the jeep is parked outside^) 





'Dash Martin 


\ 

㈣ 
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encapsulation 


Put is the RealName field REAUY protected? 

So as long as the KGB doesn’t know any CIA agent passwords, the 
CIA’s real names are safe. Right? But what about the field declaration 
for the realName field: 


youv v/avidbles ds 
fublid medv>s *tKcy be 
atttsstd) av>d cvcy> 

-fvom OU*tsidc dldss. 


public string RealName 


I4B U6FT THB FI BUD 
PUBUI6—VOHY ^ 
THR^Ud^H AUU O? THB 

TO 6^UBSS 

HIS PASSWORD? I CAN 
JUST ^BT HIS MAMB 
DIRB^TUYi 


ouhidc ihe dciss. VCh 



string name = ciaAgent. RealName; 





W，dc U 州产 k 奴 . 



Agent Jones can use private fields to keep his identity secret from 
enemy spy objects. Once he declares the realName field as private, the 

only way to get to it is by calling methods that have access to the 
private parts of the class. So the KGB agent is foiled! 



The kgbAgcht object 匕 a/t 

access -the ^iaAgcht^s private 

卜幻 usc ihsta^cs 

° + classes. 


Just with 


pjnva-tc, ^hd boorh, youv - ^ private string realName 

p^lds 3^ how hiddch r - 

TVorn 



"the V/o\rld. 



Aepmg you\r -fields a^d methods 
private suve v\o outside 
Code is go'mg -to make -to 

"the values youVc us'm^ whe^ you 

do^i it. 


suve 


⑽太巧 P 匕 

i\,t ⑼叫 ayA w to 1 . 



货办〜 _ 

Why do you think we used an uppercase 
R for the public field, but switched to a 
lowercase r for the private one? 
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keeping secrets 


Private fields and methods caw only be 
accessed from inside the class 


There’s only one way that an object can get at the data stored inside another 
object’s private fields: by using the public fields and methods that return the data. 
But while KGB and MI5 agents need to use the AgentGreeting () method, 
friendly spies can see everything — any class can see private fields in other 
instances of the same class. 


is ah 

—We 

BiritishAgcht class, \v 
So 1 七 docsh ； -t have ^ 

fields either 


栋 aUk fields avc 

七 Wis is yveib/ wutii oA^j 
Y/ay cav\ y*b tV^c 

I / v-cal 扒 aw. 


AgentGreeting( M the crow 


flies at midnight") 


OtA 

c\di 

c^v\ see 


^^o-thev- 
9 Ch "t obje^-i 










thereiare no o 

Dumb Questions 


way 



OK, so I need to access private data through 
public methods. What happens if the class with the 
private field doesn’t give me a way to get at that 
data, but my object needs to use it? 

A! Then you can’t access the data from outside the 
object. When you’re writing a class, you should always 
make sure that you give other objects some way to 
get at the data they need. Private fields are a very 
important part of encapsulation, but they’re only part 
of the story. Writing a class with good encapsulation 
means giving a sensible, easy-to-use way for other 
objects to get the data they need, without giving them 
access to hijack data your class depends on. 

Why would I ever want a field in an object 
that another object can’t read or write? 

A! Sometimes a class needs to keep track of 
information that is necessary for it to operate, but that 
no other object really needs to see. Here’s an example. 
When computers generate random numbers, they use 
special values called seeds. You don’t need to know 
how they work, but every instance of 


Random actually contains an array of several dozen 
numbers that it uses to make sure that Next () 
always gives you a random number. If you create an 
instance of Random, you won’t be able to see that 
array. That’s because you don’t need it—but if you 
had access to it, you might be able to put values in it 
that would cause it to give nonrandom values. So the 
seeds have been completely encapsulated from you. 


Hey, I just noticed that all of the event 
handlers I’ve been using have the private 
keyword. Why are they private? 

Because C# forms are set up so that only the 
controls on the forms can trigger event handlers. 

When you put the private keyword in front of 
any method, then that method can only be used from 
inside your class. When the IDE adds an event handler 
method to your program, it declares it as private so 
other forms or objects can’t get to it. But there’s no rule 
that says that an event handler must be private. In fact, 
you can check this out for yourself—double-click on a 
button, then change its event handler declaration to 
public. The code will still compile and run. 


one otject 
can get to 
ctata stored 
in a private 
held inside 
anotlier 
object of a 
diiierent 


type is hy 
using public 


metkocts 
tkat return 
tke data* 
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c^^rpen your pencil 


Here’s a class with some private fields. Circle the statements 
below that won’t compile if they’re run from outside the class 
using an instance of the object called my Super Chef. 


class SuperChef 

{ 

public string cookieRecipe; 
private string secretIngredient; 

private const int loyalCustomerOrderAmount = 60; 

public int Temperature; 

private string ingredientSupplier; 

public string GetRecipe (int orderAmount) 


if (orderAmount >= loyalCustomerOrderAmount) 


; 



1 

return cookieRecipe + ’▼ 

’▼ + secretlngredient; 

J 

else 

r 



i 

return cookieRecipe; 



1. string ovenTemp = mySuperChef.Temperature; 

2. string supplier = mySuperChef.ingredientSupplier; 

3. int loyalCustomerOrderAmount = 54; 

4. mySuperChef•secretlngredient = "cardamom"; 

5. mySuperChef.cookieRecipe = "get 3 eggs , 2 1/2 cup flour, 1 tsp salt, 
1 tsp vanilla and 1 . 5 cups sugar and mix them together. Bake for 10 
minutes at 375 . Yum! f, ; 

6. string recipe = mySuperChef.GetRecipe (56); 

7. After running all of the lines that will compile above, what’s the value of recipe? 
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leaving something to the imagination 

- c^^rpen your pencil 


Here’s a class with some private fields. Circle the statements below 
that won’t compile if they’re run from outside the class using an 

instance of the object called my Super Chef. 


class SuperChef 


public string cookieRecipe; 

private string secretlngredient; 

private const int loyalCustomerOrderAmount 

public int Temperature; 

private string ingredientSupplier; 


60 


public string GetRecipe (int orderAmount) 

{ 

if (orderAmount >= loyalCustomerOrderAmount) 

{ 


return cookieRecipe 


secretlngredient; 


else 

{ 


return cookieRecipe; 


T\\c ^ *to 七 

ordtr a ^olc 

|o*t of tookics. 0u*b«dc code 

a“css 七 Wis Acid 細咐 


Cj^ gtring ovenTemp = mySuperChef.Temperature 
string supplier = mySuperChef. ingredientSupp 



3. int loyalCustomerOrderAmount = 54 



•I ' 七 乙 。… pile because you 
^ht jus-t ass ， 如 iht •(» a 
s-fevihg. 


ad 养午 dor / 七 Compile 

_ _ _because av\d 

4. mySuperChef . secretlngredient = n cardamom^^ se 〜 e 七 ave p\riva*tc- 

5. mySuperChef.cookieRecipe = "Get 3 eggs , 2 1/2 cup flour, 1 tsp salt, 

1 tsp vanilla and 1.5 cups sugar and mix them together. Bake for 10 

minutes at 375. Yum! pvch though you Sealed a lo^al vaHable called 

loyalCustor ， cirAr,ouh-t 5hd sci H h> ^ that 

6. string recipe = mySuperChef . GetRecipe (56) ; t the objects loyalCus-tomcvA i 

value, whidh is still i>0^so it 
ihgvcdicht. 


7. After running all of the lines that will compile above, what’s the value of recipe? 
u ^c*t i cjjs, Z 1/2. dup -flouv, I *tsp sal*t> I *bp vanilla 1^ dups sugav- mix. -them •fcoythcr. 

Bake (or \0 m*mu*tcs a*t 37 1 ?. Yuw\| w 
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encapsulation 



SOMETH I RBAUUY NOT Rl 公 HT 

HBRB. IF I MAKB A FIBUD PRIVATB ； AUU THAT 
D 沉 S IS KEEP MY PR^RAM FR(9M C^MPIUIN^ 
AM^THBR CUASS THAT TRI6S TO USB IT. BUT IF 
工 JUST CHAN&B THE ''PRIVATB^ T^) ' V PUBUI6 ；/ MY 
PR^RAM BUIUDS A^AIMi ADDING ''PRIVATB^ 
JUST BR^ICB MY PR^RAM. SO WHY WOULD 工 
6VBR WAMT JO MAKB A FIBUD PRIVATB? 


Because sometimes you want your class to 
hide information from the rest of the program. 

A lot of people find encapsulation a little odd the first time 
they come across it because the idea of hiding one class’s 
fields, properties, or methods from another class is a little 
counterintuitive. But there are some very good reasons that 
you’ll want to think about what information in your class to 
expose to the rest of the program. 


Encapsulation makes your classes... 

★ Easy to use 

You already know that classes use fields to keep track of their state. And a lot 
of them use methods to keep those fields up to date —— methods that no other 
class will ever call. It’s pretty common to have a class that has fields, methods, 
and properties that will never be called by any other class. If you make those 
members private, then they won’t pop up in the IntelliSense window later 
when you need to use that class. 

★ Easy to maintain 

Remember that bug in Kathleen’s program? It happened because the form 
accessed a field directly rather than using a method to set it. If that field had 
been private, you would have avoided that bug. 

★ Flexible 

A lot of times, you’ll want to go back and add features to a program you 
wrote a while ago. If your classes are well encapsulated, then you’ll know 
exactly how to use them later on. 


Encapsulation 
means kavingf 
one class kicte 
inioritiation 
: from anotker. 

It kelps you 
prevent tugs in 
your programs. 



How could building a poorly encapsulated class now 
make your programs harder to modify later? 
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mike’s mess 


Mike's navigator program could use better encapsulation 

Remember Mike’s street navigation program from Chapter 3? Mike joined a 
geocaching group, and he thinks his navigator will give him an edge. But it’s been a 
while since he’s worked on it, and now he’s run into a little trouble. Mike’s navigator 
program has a Route class that stores a single route between two points. But he’s 
running into all sorts of bugs because he can’t seem to figure out how it’s supposed 
to be used! Here’s what happened when Mike tried to go back to his navigator and 
modify the code: 

* Mike set the StartPoint property to the GPS coordinates of his home 
and the EndPoint property to the coordinates of his office, and checked 
the Length property. It said the length was 15.3. When he called the 
GetRouteLength () method, it returned 0. 

* He uses the SetStartPoint () property to set the start point to the 
coordinates of his home and the SetEndPoint () property to set the end 
point to his office. The GetRouteLength ( ) method returned 9.51, and 
the Length property contained 5.91. 

* When he tried using the StartPoint property to set the starting point and 
the SetEndPoint () method to set the ending point, GetRouteLength ( ) 
always returned 0 and the Length property always contained 0. 

* When he tried using the SetStartPoint () method to set the starting point 
and the EndPoint property to set the ending point, the Length property 
contained 0, and the GetRouteLength () method caused the program to 
crash with an error that said something about not being able to divide by zero. 


is a spoirt v/hcv-c people 

use thciv 与 PS haviga^s h> hide 

3hd seek ^Oh-taihCVs that be 
hiddeh ih ^ wov-ld. 

嫩 e is vcally m-to ^PS so 

you see why k likes ii so 你 u 匕 h. 



c^terpen your pencil 


Here’s the Route object from Mike’s navigator program. Which properties 
or methods would you make private in order to make it easier to use? 


Route 

StartPoint 

EndPoint 

Length 

GetRouteLength() 

GetStartPoint() 

GetEndPoint() 

SetStartPoint() 

SetEndPointQ 

ChangeStartPoint() 

ChangeEndPointQ 


Thcv-c av-c lots o( ways -to solve -tliis f\roblcm, ail po-tc^-tially i/VVitc dov/^ -the o^c you tU is best- 
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encapsulation 


Think of aw object as a black box 

Sometimes you’ll hear a programmer refer to an object as a “black box/ 5 
and that’s a pretty good way of thinking about them. When you call an 
object’s methods, you don’t really care how that method works — at least, 
not right now. All you care about is that it takes the inputs you gave it and 
does the right thing. 


When you come back to code 
that you haven’t looked at in 
a long time, it’s easy to forget 
how you intended it to be used. 
That’s where encapsulation can 
make your life a lot easier! 


工 ICM^W MY 
OBJBCT VJO^KSl 
VONAT MATTBRS TO MB 
IS FI^URIN^ OUT 
ViOVJ JO USB IT MY 


H you 
encapsulate 
your classes 
well tocta 二 
tkat makes 
tliem a lot 
easier to reuse 
tomorrow. 


Start Point 





Batk m 0 ^份 ' 離 C ^as tWmkm^ 

about V.OV, -to W»ia W,S 

^ akou-t ^ 

払 c Route ofejett v/ovked. but that 

v/ds a >wWilc 

Sm 仪从队 ^ ^ 

釙 ( He、b — ••七匕？ I ，七，… 

k^ 0 V/s \i v/o^rks Y/cll -to kc ^ al 7 

U s^ul W W,s 七， . /一 

-to 'reuse Wis Route object. 

0 «lv Mike had aboui 

\ c ^a ? sulat.o^ ^ o^^allv W.lt 
W,s Route ¥! I“dad, 七 ^ 

a V.cada^c Way. 




Rijh*t r\ovj, Mike jus*t v/a^*ts *to *tlVmk 
about his Rou*tc objcd*t as a bladk b 。 乂 . 
Wt v/3^*U *to -feed his doo\rd*ma*tcs *m*to i*t 
grt a ou *t it ttc doesr / 七 

wa 的七 *to 七 h’mk dbou't how the Rou*tc 
dalduld*tes 七 length...a 七 leas 七⑽七 


Length 
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good ideas for easy encapsulation 



SO (K WBUU-BM^APSUUATBD 
6UASS DOSS BXACTUYTHB SAMB 
THIN^ AS Om THAT HAS POOJl 
BM^APSUUATI^Ni 


Exactly! The difference is that the well- 
encapsulated one is built in a way that 
prevents bugs and is easier to use. 

It’s easy to take a well-encapsulated class and turn it into a poorly 
encapsulated class: do a search-and-replace to change every 
occurrence of private to public. 

And that’s a funny thing about the private keyword: you can 
generally take any program and do that search-and-replace, and 
it will still compile and work in exactly the same way. That’s one 
reason that encapsulation is difficult for some programmers to 
understand. 


Until now, everything you’ve learned has been about making 
programs do things — perform certain behaviors. Encapsulation 
is a little different. It doesn’t change the way your program 
behaves. It’s more about the “chess game” side of programming: 
by hiding certain information in your classes when you design 
and build them, you set up a strategy for how they’ll interact later. 
The better the strategy, the more flexible and maintainable your 
programs will be, and the more bugs you’ll avoid. 



jus 七 like cMtss, ^ aUos 七 udWrted v'umbcv 

of possible cr\dapsulatiov> s-tv-atc^icsl 
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A few ideas for encapsulating classes 


encapsulation 


玲 Think about ways the fields can be misused. 

What can go wrong if they’re not set properly? 


玲 Is everything in your class public? 

If your class has nothing but public fields and methods, you probably 
need to spend a little more time thinking about encapsulation. 


玲 What fields require some processing or calculation to 
happen when they're set? 

Those are prime candidates for encapsulation. If someone writes 
a method later that changes the value in any one of them, it could 
cause problems for the work your program is trying to do. 


THB COST O? 

D6C^>12ATI^MS NJ66DS TO BB 
FI^U126D OUT FI12ST- ONCE Y^U 
K^OVJ THAT, VOU 6ANJ JUST ADD IT 
UP WITH TH6 COST O? TH6 FOOt> AMD 
D12INJIC TO 夕 ST THB TOTAL 



冷 Only make fields and methods public if you need to. 

If you don’t have a reason to declare something public, don’t. You could 
make things really messy for yourself by making all of the fields in your 
program public — but don’t just go making everything private, either. 
Spending a little time up front thinking about which fields really need to 
be public and which don’t can save you a lot of time later. 
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get it, set it, got it, good 


Encapsulation! keeps your data pristine 

Sometimes the value in a field changes as your program does 
what it’s supposed to do. If you don’t explicitly tell your program 
to reset the value, you can do your calculations using the old 
one. When this is the case, you want to have your program 
execute some statements any time a field is changed — like 
having Kathleen’s program recalculate the cost every time 
you change the number of people. We can avoid the problem 
by encapsulating the data using private fields. We’ll provide a 
method to get the value of the field, and another method to set 
the field and do all the necessary calculations. 


A quick example of encapsulation 

A Farmer class uses a field to store the number of cows, and 
multiplies it by a number to figure out how many bags of cattle 
feed are needed to feed the cows: 




We used camelCase for 
the private fields and 
PascalCase for the public 
ones. PascalCase means 
capitalizing the first 
letter in every word in the 
variable name. camelCase 
is similar to PascalCase, 
except that the first letter 
is lowercase. That makes 
the uppercase letters look 
like M humps” of a camel. 


Youv- Codt is casicv -to \read you use 
do^sis-tc^-t dhoos'mj 灼 a … es -Pov- -fields, 

pv-opcvtics, vaviablcs, ar\d methods This is a 
do^vch-tioh -that a lot of pvojvarwmcv-s ^folloy/. 


class Farmer 



private int numberOfCows; 


l/Vc'd better 啪 akc tWis f ield —ate 

so nobody ^ it also 

bajsO-fFccd— 

out synd, 诚 ’ll Wjs! 


When you create a form to let a user enter the number of cows into a numeric field, 
you need to be able to change the value in the numberOf Cows field. To do that, 
you can create a method that returns the value of the field to the form object: 


丁 he ^av-wcv 

^0 bay 


public const int FeedMultiplier 
public int GetNumberOfCows() 

{ 

return numberOfCows; 


30 



Wt II add d method h> jive 

other classes a way -fco get (ji I 

"the humbev* o-f ^ows. 一 > 



public void SetNumberOfCows(int newNumberOfCows ) 


numberOf Cows = newNumberOf Cows; Kcvc^s d method *to sc*t 七 ^ 

BagsOfFeed = numberOfCows * FeedMultiplier; 払 a 七 makes 如代 

T P 仏 C BayO-fFccd (\t\d »s 

-too. Ko>w v \0 V/3Y W tv^c 


r>umbcvO-(*Co>ws is a fv-"iva*tc 
-field ； so >wc used 
v/c earned i*t- 


*t\y/0 *bo ou*t 〒匕 . 
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encapsulation 


Properties make encapsulatioH easier 


You can use properties, which are methods that look just like fields to other 
objects. A property can be used to get or set a backing field, which is just a 
name for a field set by a property. 




m rc—e 如 ? ,Watc^.cld-to 

dcd 糾 “ Wumb^^Cows 

» :㈣ 工 二 . 

return numberOfCows; 


private int numberOfCo 

public int NumberOfCows 

{ 


} 





numberOfCows 
BagsOfFeed = 


h r; 二二 ^ t:t 

called value i^ai whatever value tk ^\ d was sci 仏 

=value; 

numberOfCows * FeedMultiplier; 


} 


You use get and set accessors exactly like fields. Here’s code for a button that sets the 
number of cows and then gets the bags of feed: 

private void buttonl_Click(object sender, EventArgs e) 
Farmer myFarmer = new Farmer(); 
myFarmer.NumberOfCows = 10; 

int howManyBags = myFarmer.BagsOfFeed; < 


W\)tv\ this I'mc sets 
/Vurhbc\rO-PCows -fco lO, the 
srt 96 desso\r sets -the 
private hurwbc\rO-PCows -field 
ahd thch updates -the public 
BagsO-fFccd -field- 


myFarmer.NumberOfCows = 20; 
howManyBags = myFarmer.BagsOfFeed; 


"tKc ^urnbc\rO-(*Cows set 

3Uesso\r updated BayO^Fced, 
how you get its value- 


code brtaU 

a -tKc set a f css ^ as ； l p ；； ^ , 

七 y 七 attessov, v/Vu 乩 v-c*tuv^s 2.0 t>0 
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private property (no trespassing) 

Puild aw application to test the Farmer class 




Create a new Windows Forms application that we can use to test the 
Farmer class and see properties in action. The Console. WriteLine () 
method will write the results to the Output Window in the IDE. 



Add the Farmer class to your project: 

class Farmer { 

public int BagsOfFeed; 


WatcK il 


Console output 
is displayed in 
the Output 
window. 

When a Windows 


public const int FeedMultiplier = 30; 


Forms application uses the 


private int numberOfCows; 
public int NumberOfCows { 

// (add the get and set accessors from the 
// previous page) 


❺ 


Build this form: 


□9 Cow calculator 


Kdme button w daldula*tc w — 
uses fublid Favmcv" *to 


y/vi*tc 3 Imc *to 



Console•WriteLine() 

method to write output, the 
ouptut is displayed in the 
Output window in the IDE. 
WinForms apps don’t typically 
use console output, but we will 
use it extensively as a learning 
tool. 


Set "the Wumcv-i^UpPoy/h 

^Oht\rols \/aluc -to 1^, i-ts 
Mihimurh -to ^ ahd its 
{jo 1>00. 





Here’s the code for the form. It uses Console . WriteLine () to send its output to the Output 
window (which you can bring up by selecting “Output” from the Debugs Windows menu). You can 
pass several parameters to WriteLine () — the first one is the string to write. If you include “ { 0 } ’’ 
inside the string, then WriteLine () replaces it with the first parameter. It replaces “ {1} ’’ with the 
second parameter, “ { 2 } ” with the third, etc. 

public partial class Forml : Form { 

Farmer farmer; 
public Forml() { 

InitializeComponent(); 

farmer = new Farmer() { NumberOfCows =15 }; 

} 

private void numericUpDownl_ValueChanged(object sender, EventArgs e) { 
farmer.NumberOfCows = (int)numericUpDownl.Value; 


private void calculate_Click(object sender, EventArgs e) { 
Console • WriteLine ( ，，工 need {0} bags of feed for {1} cows 
farmer•BagsOfFeed, farmer.NumberOfCows); 


Use "the Consolc lVv-i-tcL'mcO 
rwrthod *fco a Imc o( 

■fco 七 he IDE’s Output y/'md ov/. 



{o} v/i*b^ 』 
value m -fivs-t pavamc-tcv, a^d U 
v/i-tK second pavamcW. 
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Don’t forget that controls need to be “hooked up” to their event 
handlers! Double-click on Button and NumericUpDown in the 
designer to make the IDE create their event handler method stubs. 


























encapsulation 


Use automatic properties to fmish the class 


It looks like the Cow Calculator works really well. Give it a shot — run it and click the button. Then change the number 
of cows to 30 and click it again. Do the same for 5 cows and then 20 cows. Here’s what your Output window should 
look like: 




you see 

how this dould 
lead you -to 
addideivt^lly 
add a \rcally 

bu^ \ y \ 

youv- pv-ojv-am? 


But there’s a problem with the class. Add a button to the form that executes this statement: 

farmer.BagsOfFeed = 5; 

Now run your program again. It works fine until you press the new button. But press that button and then press 
the Calculate button again. Now your ouput tells you that you need 5 bags of feed — no matter how many cows you 
have'. As soon as you change the NumericUpDown, the Calculate button should work again. 



Fully encapsulate the Farmer class 


The problem is that your class isn’t fully encapsulated. You used properties to encapsulate 

NumberOf Cows, but BagsOf Feed is still public. This is a common problem. In fact, it’s so common that G# 

has a way of automatically fixing it. Just change the public BagsOf Feed field to an automatic property. 

And the IDE makes it really easy for you to add automatic properties. Here’s how: *t3b dodc sr\'i P 产七 

Idds dr> au*to 你 pvofcvty *to 
/ouv dodc- 


o 




Remove the BagsOf Feed field from the Farmer class. Put your cursor where the field used to 
be, and then type prop and press the Tab key twice. The IDE will add this line to your code: 


public int MyProperty { get; set; 


❺ Press the Tab key — the cursor jumps to MyProperty. Change its name to BagsOf Feed: 


public int BagsOfFeed { get; set; 


Now you’ve got a property instead of a field. When G# sees this, it works exactly the same as if you had 
used a backing field (like the private numberOf Cows behind the public NumberOf Cows property). 


❺ 


That hasn’t fixed our problem yet. But there’s an easy fix — just make it a read-only property: 

Try to rebuild your code — you’ll get an error on the line in the button that sets BagsOf Feed telling 
you that the set accessor is inaccessible. You can’t modify BagsOf Feed from outside the 
Farmer class — you’ll need to remove that line in order to get your code to compile, so remove the 
button and its event handler from the form. Now your Farmer class is better encapsulated! 
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set it up 


What if wg want to change the feed multiplier? 

We built the Cow Calculator to use a const for the feed multiplier. But what if we 
want to use the same Farmer class in different programs that need different feed 
multipliers? You’ve seen how poor encapsulation can cause problems when you 
make fields in one class too accessible to other classes. That’s why you should only 
make fields and methods public if you need to. Since the Cow Calculator 
never updates FeedMultiplier, there’s no need to allow any other class to set it. 

So let’s change it to a read-only property that uses a backing field. 



命命 

侧餐 


O Remove this line from your Farmer class: 

public const int FeedMultiplier 


30 


Use prop-tab-tab to add a read-only property. But instead of adding 
an automatic property, use a backing field: 


private int feedMultipiiere¬ 
public int FeedMultiplier { get { return feedMultiplier; 


二娜 4: 纖 

代 ad -崎 I 七心”舢 6 M 

—aU 如“加 vb wd - ，七❻ 

Llv be set ky av ， We d 




s*tav-*b 


ie a fubl.d a fnvatc ml v/c ^ so ^ 

a loy/ev-dase Tha 仏 a pv-etty sla^dav-d to^hor^ you II see tWou^out tKe book 


o Go ahead and make that change to your code. Then run it. Uh oh — something’s wrong! 

BagsOf Feed always returns 0 bags. 

Wait, that makes sense. FeedMultiplier never got initialized. It starts out with the 
default value of zero and never changes. When it’s multiplied by the number of cows, 
it still gives you zero. So add an object initializer: 

public Forml() { 

工 nitializeComponent (); 

farmer = new Farmer() { NumberOfCows 二 15, feedMultiplier =30 }; 

Uh oh — the program won’t compile! You should get this error: 



Check the Error 
List window for 
helpful warnings 
from the IDE 
about things 
like forgetting 
to initialize a 
variable before 
using it. 


You can only initialize public fields and properties inside an object initializer. 
So how can you make sure your object gets initialized properly if some of 
the fields that need to be initialized are private? 
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encapsulation 


Use a constructor to initialize private fields 


If you need to initialize your object, but some of the fields that need to be initialized 
are private, then an object initializer just won’t do. Luckily, there’s a special method that 
you can add to any class called a constructor. If a class has a constructor, then that 
constructor is the very first thing that gets executed when the class is created with 
the new statement. You can pass parameters to the constructor to give it values that need 
to be initialized. But the constructor does not have a return value, because you don’t 
actually call it directly. You pass its parameters to the new statement. And you already 
know that new returns the object — so there’s no way for a constructor to return anythii 


All you have to do to 
add a constructor 
to a class is add a 
method that has the 
same name as the 
class and no return 
value. 


O At>t> A C^bJSmUCT^R TO YOU1Z FAJ2MB1Z CUASS^ 

This constructor only has two lines, but there’s a lot going on here. So let’s take it step by step. We already know 
that we need the number of cows and a feed multiplier for the class, so we’ll add them as parameters to the 
constructor. Since we changed f eedMultiplier from a const to an int, now we need an initial value for 
it. So let’s make sure it gets passed into the constructor. We’ll use the constructor to set the number of cows, too. 


The w *this w 

keyv/ovd 

-fccdMultiplicv- -tells 
C 养 ihsi youVc 
-talking about 
•field, Y\o{, 
pav-amc*tcv- 




That's because 心 stvu 如 vs Aor!i iiavc a value. 


public Farmer(int numberOfCows, int feedMultiplier) { 

this • feedMultiplier = feedMultiplier ; ^ -thihj we'll do 

’ _ ^| ausc ^ ^ceds io be sci 

l-f wc \us*t scL ihc fv*iva*tc ^umbcvO-fCov/s -field, NumbcvO-fCovys set adtessov the 

would wv* be dalled- Numbcv*0-PCoy/s makes suv-c i*ts tailed- OY/s se i3/ * / 


NumberOfCows = numberOfCows 


} 




This is cvvov- 
youll i-f 
youv d 。 灼 s*bru^bo\r^^^ 
takes pa\ramc*tc\rs 
bu 七 youv 

does 灼’七 have 



@ CHANTS THB F^>12M SO THAT IT USBS THB ⑵ NSTRUCTd 

The only thing you need to do now is change the form so that the new statement that creates the Farmer 
object uses the constructor instead of an object initializer. Once you replace the new statement, both errors will 
go away, and your code will work! . 





public Forml() { 

InitializeComponent(); 
farmer = new Farmer(15, 30); 


/ou dlv'Cddy kr\ov/ *tv^c -fovm is ar\ 

object. Well it's 5o*t a U^sbryAt{x>r W 
TV^aVs tWis mc-tiiod V^oy/ 

its Fovml (like dass) ad it 

dotsr\i iidve a value- 

肴 


whcv'C the dalU 七1 化 do 灼 stiru^toV". I 七 looks jus*t like ctiicv" 

i\\ai i*t has faramc*tc\rs ihai i*t passes m-to the do^si\rud*to\r me 

W\\Cy\ you *tyfC >*t \y\, v/a'tdh *Pov* 七1 化 |r>*tclliSc^sc pof uf—it looks just like any wtiiod 


Y\t^ 

»e*thod- 
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constructors deconstructed 



C^nsfructars 

VayUp Ckse 


Co^s-t\rud-to\rs do 灼’七 
v-ctuv-^ so 

■thcv-c^s y\o v-ctu\r^ "type. 


Let’s take a closer look at the Farmer constructor so we can get a good sense 
of what’s really going on. 

TKis cov^sbryAcbor V^as W pava^c-tcv-s, y/ovk just like 
ovdmavy pavamc-tcvs. ^ivst or^c 5WCS r>umbcv ok Co^s, 

3r\d sctor\d or\t is -feed mul 七 ipl’d 


F^mer (int 


public 

this.feedMultiplier 


{ 



Wt Y\ttd {p set -feed mul*tiplicv -f iv-st, 

feedMultiplier; because the stto^A statement ta\U -the 

Kumbcv* 0 -fCo>ws set addessor, v/lVi 匕 h Y\ttds 

NumberOfCows = numberOfCows; -feedMultiplier -to have a value m <^dcr{o 

l/Vc y\ttd a way -fco di-ffcv-c^-tiatc *thc -field called ^ 

-PccdMultipl iev- -fv-om 七 he pav-amrtev- W\{\\ 七 he w *this w is aWiays a rc-Pcrchdc -fco -the duvinch-t objed-t, -tWis.-Pccd(Mu|-tiplicv| 

same Y\B\n\t- That’s v/hcv-c *thc “七 his” keywov-d Vic-Pc\rs -fco -the -Pidd I-P you leave w *this w off, {\)Or\ -PccdMul-bplicv- \rtfcvs 

"to *thc pav-ametev-. So -tiic -Piv^t lii^c m "the dojr^nA^fcoV' set "the private 
-PccdAlul-tiplicv- -field equal "to -the sttor\A pav-arwrtev- of -the dohstnAfrfcor- 


domes m v-cally ha^dy. 


thereiar 

)umb 


D 

Is it possible to have a constructor without any 
parameters? 

Yes. It’s actually very common for a class to have a 
constructor without a parameter. In fact, you’ve already seen an 
example of it— your form’s constructor. Look inside a newly 
added Windows form and find its constructor’s declaration: 

public Forml() { 

InitializeComponent(); 


That’s the constructor for your form object. It doesn’t take any 
parameters, but it does have to do a lot. Take a minute and open up 
Forml.Designer.es. Find the InitializeComponent() 
method by clicking on the plus sign next to “Windows Form 
Designer generated code." 

That method initializes all of the controls on the form and sets 
all of their properties. If you drag a new control onto your form 
in the IDE’s form designer and set some of its properties in the 
Properties window, you’ll see those changes reflected inside the 

InitializeComponent () method. 


e no ^ 

Questions 

The InitializeComponent () method is called inside 
the form’s constructor so that the controls all get initialized as soon as 
the form object is created. (Remember, every form that gets displayed 
is just another object that happens to use methods that the .NET 
Framework provides in the System. Windows . Forms 
namespace to display windows, buttons, and other controls.) 



Watch it! 


When a method’s parameter 
has the same name as a field, 
then it masks the field. 


The constructor’s feedMultiplier 

parameter masks the backing field 
behind the FeedMul tiplier property because 
they have the same name, so the parameter takes 
precedence inside the body of the constructor. 

If you wanted to use the backing field inside 
the constructor, you’d use the this keyword: 
feedMultiplier refers to the parameter, and 
this. feedMul tiplier refers to the private field. 
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Hcvc s a V^clf-ful v/ay *to vemembev y/ha 七 '如 s " 
does: *twk oJf it as sliort (or ms*tar\dc. 















Why would I need complicated 
logic in a get or set accessor? Isn’t it just 
a way of creating a field? 

Because sometimes you know that 
every time you set a field, you’ll have to do 
some calculation or perform some action. 
Think about Kathleen's problem—she ran 
into trouble because the form didn’t run 
the method to recalculate the cost of the 
decorations after setting the number of 
people in the Dinnerparty class. If we 
replaced the field with a set accessor, then 
we could make sure that the set accessor 
recalculates the cost of the decorations. (In 
fact, you’re about to do exactly that in just a 
couple of pages!) 

Wait a minute—so what’s the 
difference between a method and a get or 
set accessor? 

A! There is none! Get and set accessors 
are a special kind of method—one that looks 
just like a field to other objects, and is called 
whenever that “field” is set. Get accessors 
always return a value that’s the same type 
as the field, and set accessors always take 
exactly one parameter called value 
whose type is the same as the field. Oh, 
and by the way, you can just say “property” 
instead of “get and set accessor.” 

So you can have ANY kind of 
statement in a property? 

A: Absolutely. Anything you can do in a 
method, you can do in a property. They can 
call other methods, access other fields, even 
create objects and instances. But they only 
get called when a property gets accessed, 
so it doesn’t make sense to have any 
statements in them that don’t have to do with 
getting or setting the property. 



If a set accessor always takes a 
parameter called value, why doesn’t 
its declaration have parentheses with the 
“int value” parameter in them, like 
you’d have with any other method that 
takes a parameter called value? 

A! Because C# was built to keep you from 
having to type in extra information that the 
compiler doesn't need. The parameter gets 
declared without you having to explicitly type 
it in, which doesn’t sound like much when 
you’re only typing one or two—but when you 
have to type a few hundred, it can be a real 
time saver (not to mention a bug preventer). 

Every set accessor always has exactly one 
parameter called value, and the type of 
that parameter always matches the type of 
the property. C# has all the information it 
needs about the type and parameter as soon 
as you type set {. So there’s no need for 
you to type any more, and the C# compiler 
isn’t going to make you type more than you 
have to. 

! Wait a sec—is that why I don’t add a 
return value to my constructor? 

A! Exactly! Your constructor doesn’t have 
a return value because every constructor 
is always void. It would be redundant to 
make you type void at the beginning of 
each constructor, so you don’t have to. 

Can I have a get without a set or a 
set without a get? 

Yes! When you have a get accessor 
but no set, you create a read-only property. 
For example, the SecretAgent class 
might have public read-only field with a 
backing field for the name: 


encapsulation 


string name = n Dash Martin"; 
public string RealName { 
get { return name; } 

} 

And if you create a property with a set 
accessor but no get, then your backing 
field can only be written, not read. The 
SecretAgent class could use that for a 
Password property that other spies could 
write to, but not see: 

public string Password { 
set { 

if (value == secretCode) { 
name = "Herb Jones"; 


Both of those techniques can come in really 
handy when you’re doing encapsulation. 

! I’ve been using objects for a while, 
but I haven’t written a constructor. Does 
that mean some classes don’t need one? 

No, it just means that C# automatically 
makes a zero-parameter constructor if 
there’s none defined. If you define a 
constructor, then it doesn’t do that. That’s a 
valuable tool for encapsulation, because it 
means that you have the option—but not the 
requirement—to force anyone instantiating 
your class to use your constructor. 


Properties (get and 
set accessors) are 
just anotker kind 
ol C# metkod tliat’s 
only run wlien tke 
property value is react 
or written* 

you are here ► 


Here's something useful: the first line of a method that contains 
the access modifier, return value, name, and parameters is 
called the method's signature. Properties have signatures, too. 
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whafs in a name? 


c^^rpen your pencil 


class CableBill 


Take a look at the get and set accessors here.The form that is using this 
class has a new instance of CableBill called thisMonth and calls 
the GetThisMonthsBill () method with a button click. Write down 
the value of the amountOwed variable after the code below executed. 


private int rentalFee; 
public CableBill(int rentalFee) { 
this.rentalFee = rentalFee; 
discount = false; 


private int payPerViewDiscount; 
private bool discount; 
public bool Discount { 
set { 

discount = value; 
if (discount) 
payPerViewDiscount = 2; 
else 

payPerViewDiscount = 0; 


public int 
return 


CalculateAmount(int payPerViewMoviesOrdered) { 

(rentalFee 一 payPerViewDiscount) * payPerViewMoviesOrdered; 



2 • 


CableBill january = new CableBill(4); 

MessageBox.Show(january.CalculateAmount(7).ToString()); 

CableBill february = new CableBill(7); 
february.payPerViewDiscount = 1; 

MessageBox.Show(february.CalculateAmount(3).ToString()); 


What’s the value of 

amountOwed? 


What’s the value of 

amountOwed? 


3. CableBill march = new CableBill(9); 

march.Discount = true; - 

MessageBox.Show(march.CalculateAmount(6).ToStrinq()); 

What’s the value of 

amountOwed? 
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Dumb Questions 


I noticed that you used uppercase 
names for some fields but lowercase 
ones for others. Does that matter? 

A! Yes—it matters to you. But it doesn’t 
matter to the compiler. C# doesn’t care what 
you name your variables, but if you choose 
weird names then it makes your code hard to 
read. Sometimes it can get confusing when 
you have variables that are named the same, 
except one starts with an uppercase letter and 
the other starts with a lowercase one. 


c^terpen your pencil 


Case matters in C#. You can have two 
different variables called Party and 
party in the same method. It'll be 
confusing to read, but your code will compile 
just fine. Here are a few tips about variable 
names to help you keep it straight. They’re 
not hard-and-fast rules—the compiler 
doesn’t care whether a variable is uppercase 
or lowercase—but they’re good suggestions 
to help make your code easier to read. 

1. When you declare a private field, it should 
be in camelCase and start with a lowercase 
letter. (It’s called camelCase because it 
starts with a lowercase letter and additional 
words are uppercase, so they resemble 
humps on a camel.) 


encapsulation 

2. Public properties and methods are in 
PascalCase (they start with an uppercase 
letter). 

3. Parameters to methods should be in 
camelCase. 

4. Some methods, especially constructors, 
will have parameters with the same names 
as fields. When this happens, the parameter 
masks the field, which means statements 

in the method that use the name end up 
referring to the parameter, not the field. Use 
the this keyword to fix the problem—add 
it to the variable to tell the compiler you’re 
talking about the field, not the parameter. 


This code has problems. Write down what you think is wrong with 
the code, and what you’d change. 


class GumballMachine { 

private int gumballs; 


private int price; 
public int Price 
{ 

get 

{ 





else 


gumballs — — 1 ; 

return "Here A s your gumball"; 

{ 

return "Please insert more coins 


you are here ► 
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encapsulation prevents bugs 



Use what you’ve learned about properties and constructors to fix Kathleen’s Party Planner program. 
This new program will be much simpler and more consistent than the first version. 


i(ciSe 


O 


❹ 




o 


Fix the Dinner Party calculator. 

To fix the DinnerParty class, we’ll need to make sure the CalculateCostOf Decorations () 
method is called every time NumberOf People changes. We’ll do it by adding a property called Cost. 

NumberOfPeople = 10 ； 


1/Vc y\ccA *to vcdaltula*tc dcdova*tio^ dost 
evevy 七 ime 七 he r^umbcv* o( people Wt 

cby\ do 七 or^ly way *to daldula*tc "the 

dos*t is *to use a fv-ofcviy. 




——- ^ decors 

Cost property returns S650 , s yctaltula*tcd cvcv-y t ,w ' c ^ V 

the next time it’s accessed. autsstd, all need -to do ^ set t »o^s 

如 Pm^Pa^Y obje^ a,a .ts Cost. 


Use properties to set the number of people and the party options. 

You may want to create a new project, because you’re going to overhaul the 
DinnerParty class. Start by creating these three automatic properties: 

ttcvc^s -the tlass 
} did^Vdrw -fo\r Y\t^i 
P'm^cvPav-ty dlass. 


public int NumberOfPeople { get; set; } 
public bool FancyDecorations { get; set; 
public bool HealthyOption { get; set; } 


You’ll also need a constructor with this signature to set the properties: 

public DinnerParty(int numberOfPeople, bool healthyOption, 

bool fancyDecorations) 


DinnerParty 


NumberOfPeople: int 
FancyDecorations: bool 
HealthyOption: bool 
Cost: decimal 


private methods: 
CalculateCostOfDecorations() 
CalculateCostOfBeverages 
PerPersonf); 




Create private methods to calculate the intermediate costs. 

Here are signatures for the methods that help calculate the cost. Fill in their calculations: 
private decimal CalculateCostOfDecorations() { ... } 


private decimal CalculateCostOfBeveragesPerPerson() 


These should be vcv-y similav- 
*to methods you dlreddly 
v/v-o*tc a*t s*ta\rt 


dhapiev-. 

Add the read-only Cost property to calculate the cost. 

Add a property called Cost that calculates the cost of the dinner party: a S*tav ~ 七 v/i-th a 

Diiblic decimal Cost ( / _ dedind variable ^llcd -fcotalCosi 

丄 1C CieCinid •丄 LxOo L \ jL I » I . 

g et { 、 tnCK> use tnc dorwpou^d opc\raxov-s 

+ 二 and 来二 {jo modi-fy i-ts value 
bc-fov-c 七 he tmal dosi. 


// Fill in the code to calculate the cost 
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encapsulation 


❺ Update the form to use the properties. 

Here’s the complete code for the form. It uses the constructor and the three properties 
(NumberOf People, FancyDecoration, and HealthyOption) to pass information into 
the object, and it uses the Cost property to calculate the cost. 


public partial class Forml : Form 


DinnerParty dinnerParty; 
public Forml() 




The -Pov-r^ s-fco\rcs dh o( 

Dih^cv-Rairty 3hd updates rts 
properties cvcvy time the o( 

people ov pavty options 


InitializeComponent(); 

dinnerParty = new DinnerParty((int)numericUpDownl.Value, 

healthyBox.Checked, fancyBox.Checked); 
DisplayDinnerPartyCost(); 


The form uses the DinnerParty object's constructor 
to initialize it with the right values. You'll need to make 
sure your DinnerParty class has this constructor. 


private void fancyBox_CheckedChanged(obj ect sender, EventArgs e) 

{ 

dinnerParty.FancyDecorations = fancyBox.Checked; 
DisplayDinnerPartyCost(); 


private void healthyBox_CheckedChanged(object sender, EventArgs e) 

{ 

dinnerParty.HealthyOption = healthyBox.Checked; 
DisplayDinnerPartyCost(); 


private void numericUpDownl_ValueChanged(obj ect sender, EventArgs e) 

{ 

dinnerParty.NumberOfPeople = (int)numericUpDownl.Value; 
DisplayDinnerPartyCost(); 

} 

private void DisplayDinnerPartyCost() 

{ 

decimal Cost = dinnerParty.Cost; 
costLabel.Text = Cost.ToString ("c") 


The form is simpler now because it doesn't need to access the methods that do 
the calculations. Those calculations are encapsulated behind the Cost property. 


This method updates the 
pa\rly dost Oh the 
•Poirm by the 

Cost f\ropc\rty cvcv-y ti 
it updates the -Pov-m. 


you are here ► 
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exercise solution 



Tiiis idea is called W scpa\ratioh o( C-o^dev-^s/^ 扣 d rt’s a ^ood way "to "thmk 
about youv- pvoyarws. The -foiri^ do^dcv-ir\s itscl-P v/i-th 七 he usev- m 七 ev^Pade, 
while the Di^c\rRa\rtv ob 》 e^t i-tscl-P W\{\\ -the dos*t ddkuld'tio^- 


汽购鉍 
©PLyiiOH 


class DinnerParty { 
public const int 



Did you notice how your new form doesn't need to do very much? All it 
does is set properties on objects based on user input, and change its 
ouput based on those properties. Think about how the code for user 
input and output is separated from the code that does the calculation. 




CostOfFoodPerPerson 



public int NumberOfPeople { get; set; } 
public bool FancyDecorations { get; set; 
public bool HealthyOption { get; set; } 


public DinnerParty(int numberOfPeople, bool 
NumberOfPeople = numberOfPeople; 
FancyDecorations = fancyDecorations; 
HealthyOption = healthyOption; 

} 

private decimal CalculateCostOfDecorations() 
decimal costOfDecorations; 
if (FancyDecorations) 

{ 

costOfDecorations = (NumberOfPeople 

} 

else 

{ 


These p\ropc\rtics a\rc set ih -the dohstv-u^-tov 
ahd updated by -the a^d IhcyVc used 
whch dclkulatihg the dost. 


healthyOption, bool fancyDecorations) 

ttcv-c^s the D*m^c\rRav-ty ^o^sivud-tov-. li 
sets -the ihv-cc p\ropc\rtics based ov\ -the 
values passed m-to i-t by -the -Pov-rw. 




■k 


15.00M) + 50M, 


costOfDecorations 


(NumberOfPeople 


女 


•50M) + 30M; 


By makmg this method pv-iva*tc, 
you made suv-c that it cby\ *t be 
dddessed -Pv-om ou*tsidc the 
t\sss, y/hidh will keep i*t -Pv-om 
misused- 


return costOfDecorations; 


private decimal CalculateCostOfBeveragesPerPerson() 
decimal costOfBeveragesPerPerson; 
if (HealthyOption) ^ ^ 

{ — ^ ^ private 

costOfBeveragesPerPerson = 5.00M; methods used 


else 

{ 


costOfBeveragesPerPerson 


20 


return costOfBeveragesPerPerson; 


Cost 


the Cosi 

^al^ula-tioh aucss 

00M; "the pvopcvtics SO 

■that they have -the 
ih+ov-i^a-ti 
-the -Pov-rh. 


：iOh 


You had a SetHealthyOption () 
method in the first version of this 
program. Now it’s changed to a 
property called HealthyOption. 

If you have a method that starts 
with "Set" that sets a field and 
then updates the state of the 
object, changing it to a property 
could make it more obvious how 
you expect it to be used. 




public decimal 
get { 

decimal totalCost = CalculateCostOfDecorations() 
totalCost += ((CalculateCostOfBeveragesPerPerson () 

+ CostOfFoodPerPerson) * NumberOfPeople) 

if (HealthyOption) 


That's one way encapsulation 
makes your classes easier to 
understand and reuse later. 


totalCost *= .95M; 


return totalCost; 


Wow tha-t the dakulatiohs av-c pviva-tc encapsulated 
上 ehmd — Cosi pop 伙七 y, iheircs ho way 4v- ihc ^ 
■to v-cdakulatc -the ^os-t o( -the dc^ov-atiohs -that docsh ; -t 
use the duvvch't options. Thol-tll -fix the bug that 
3lmos*t dos*t ohC o-f hc\r best diCKrt^ 
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c^^rpen your pencil 


Write down the value of the amountOwed variable after the code 
below executed. 


1. CableBill january = new CableBill(4); 

MessageBox.Show(january.CalculateAmount(7) .ToString ()); 

2. CableBill february = new CableBill(7); 
february.payPerViewDiscount = 1; 

MessageBox.Show(february.CalculateAmount(3).ToString()) 

3. CableBill march = new CableBill(9); 
march.Discount = true; 

MessageBox.Show(march.CalculateAmount(6).ToString()); 


What’s the value of 

amountOwed? 



What’s the value of 

amountOwed? 



What’s the value of 

amountOwed? 



c^rp 


en your pencil 


This code has problems. Write down what you think is wrong with 
the code, and what you’d change. 


h> the io 

oTot^ hot ihc ^ ，c,d ' This ^ ^ 

P ^TBK io ihe valueWd by the 

?Y \ U 护严 ， but P 咖 eve, bL 

set yet. So ，i does^i do ahytKmg usc-Pul. y ou 
p ah 3 e 卜乙。十 udWs pa\ra^ctc\r -to u^cuase 

I \ridc ； "this lihC will wo\rk pV"opcV"ly. 

public GumballMachine(int gumballs, int brice) 

{ 

gumballs = this.gumballs; 

、: price = Price; 


Tk w W’ keyword \s ov, 了 0 口 

lo ? criy t n,W»Ic stalls refers -to 


^avawc*tcv- 



This pa\ranf»ctcv mdsks -the 
pv-ivaic -field ts\\td Pv-idc, a^d 
the says -the method is 

supposed {p be ihc value 

o( the yy\U -field- 


public string DispenseOneGumball(int price, int coinsInserted) 


T\)t w *tW’ keyword 
•is cm a pav-amcW) 
vt docsn *t 
bclo^. I*t should be 
fvitc, because 七 ha 七 
-f ield is masked by a 

pav-amc*tcv-. I 


if (this.coinslnserted >= price) 
7 gumballs —— 1; 

_j _ it 


// check the field 


return "Here A s your gumball 


else 


return "Please insert more coins 


Take an extra minute or two 
and really look at this code. 
These are some of the most 
common mistakes that new 
programmers make when 
working with objects, and 
avoiding them makes it much 
more satisfying to write code. 


you are here ► 
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Your object’s family tree 



< SO TNBRB I WAS RIDING MY 
&XCYCLB OBJECT DOWN DBAD 
.MAM，S 6URVB WH5N1 工 RBAUIZBD 
IT INHBRITBD FR^>M T^\AJh4eeueis 
AMD I fO^OT TO ^VBRRIDB THB 
& 娜 es() METHOD … UOM 多 ST^RY 
SHORT, TW6MTY-SIX STIT6HBS AMD 
M^M SAID 工 , A\ d^R^UNDBD f=OR A 
1 MONTH. ^ 


Sometimes you DO want to be just like your parents. 

Ever run across an object that almost does exactly what you want your object to do? 
Found yourself wishing that if you could just change a few things, that object would 
be perfect? Well, that’s just one reason that inheritance is one of the most powerful 
concepts and techniques in the C# language. Before you’re through with this chapter, 
you’ll learn how to subclass an object to get its behavior, but keep the flexibility to 
make changes to that behavior. You’ll avoid duplicate code, model the real world 
more closely, and end up with code that’s easier to maintain. 


this is a new chapter 
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happy birthday baby 


Kathleen does birthday parties, too 

Now that you got your program working, Kathleen is using it all the 
time. But she doesn’t just handle dinner parties — she does birthdays 
too, and they’re priced a little differently. She’ll need you to add 
birthdays to her program. 



^osi o-P the 乙 

havc do wi-th dskes 
如 d wH-fcihg. 


I JUST &OI A CAUU 
FOR A BIRTHDAY PARTY 
lO PBOPUB. 6AM Y^UE 
HAMDUB THAT? 


These avc both the 
as "the dihhCV- p3\rty. 


Cos 十 Estimate for a Bmfhdag Party 


$25 per person. (= - 

There are two opt ions for the cost of decora 十 ions. If a client 
qoes with the normal decora 十 ions，if s 求 7.S0 per person wi 十 h a pO 
deconaf ina fee. A client can also opgnadefhe party decorations 
to the Taney Decora 十 ions’，— 十 ha 十 costs $1S per person with a ^SO 

one-time decorating fee. 

When the party has foon people on fewer, ose an 8-inch cake (㈣)’ 
Otherwise, she osesa 16 - inch cake ($15). 

Writinq on the cake cos 十 s $.2S f op each (effen. The 8-inch cake can 
have op to 16 letters of writing, and the 16-inch one can have up 

to HO letters of writing. 

The application shoold handle both types of panties. Use a fab control, 
one fab for each kind of party. 


There’s no healthy option for birthday parties. Can you think of how 
this could lead to bugs if you start out a project by copying and 
pasting code from the Dinnerparty class from the last chapter? 
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Wc need a PirthdayParty class 

Modifying your program to calculate the cost of Kathleen’s 
birthday parties means adding a new class and changing the } 
form to let you handle both kinds of parties. you II do dll this'm d 

bu-t -fiv-s-t you’ll 

Here's what weVe going to do: 

O DEBATE A NSW 6UASS BIETHDAY PAETIBS. 

Your new class will need to calculate the costs, deal with 
decorations, and check the size of the writing on the cake. 

© ADD A TAB TO Y^UE 

Each tab on the form is a lot like the GroupBox control you used 
to choose which guy placed the bet in the Betting Parlor lab. Just 
click on the tab you want to display, and drag controls into it. 

O UABSU THE FIEST TAB AND M^VB THE DINNBE PAETY INTO IT- 

You’ll drag each of the controls that handle the dinner party into the new tab. They’ll work 
exactly like before, but they’ll only be displayed when the dinner party tab is selected. 


BirthdayParty 

NumberOfPeople 

CostOfDecorations 

CakeSize 

CakeWriting 

Cost 


— 


Q UABBU THE SECOND TAB AMD ADD MBW BIETHDAY PAETY CONTROLS JO IT. 

You’ll design the interface for handling birthday parties just like you did for the dinner parties. 

O VOIEB BIETHDAY PAETY CUASS UP TO THE 

Now all you need to do is add a BirthdayParty reference to the form’s fields, and 
add the code to each of your new controls so that it uses its methods and properties. 


D 


th&reicire no 

)umb Qv 


Questions 


Why can’t we just create a new instance of 
Dinnerparty, like Mike did when he wanted to compare 
three routes in his navigation program? 

Because if you created another instance of the Dinnerparty 
class, you’d only be able to use it to plan extra dinner parties. Two 
instances of the same class can be really useful if you need to manage 
two different pieces of the same kind of data. But if you need to store 

different kinds of data, you’ll need different classes to do it. 


How do I know what to put in the new class? 

A! Before you can start building a class, you need to know 
what problem it’s supposed to solve. That’s why you had to talk to 
Kathleen—she's going to be using the program. Good thing you took 
a lot of notes! You can come up with your class’s methods, fields, and 
properties by thinking about its behavior (what it needs to do) and its 
state (what it needs to know). 
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another kind of party 


Puild the Party Planner version 2.0 

Start a new project — we’re going to build Kathleen a new version of her 
program that handles birthdays and dinner parties. We’ll start by creating a well- 
encapsulated BirthdayParty class to do the actual calculation. 


Make suv-c you use de^imoil as 
the type -the -fields a^d 
p\roJ>c\rtics -that hold 






O 


ADD THE NBW BiierUMyPAieTY ^UASS JO Y^UE 

You already know how you’ll handle the NumberOf People and 
FancyDecorations properties — they’re just like their counterparts in 
DinnerParty. We’ll start by creating your new class and adding those, 
and then we’ll add the rest of the behavior. 

* Add the CostOf FoodPerPerson constant, and 
the NumberOf People and FancyDecorations 
properties. You’ll also need a private int property called 
actual Length. (Yes, properties can be private, too!) 


BirthdayParty 

NumberOfPeople: int 
FancyDecorations: bool 
Cost: decimal 
CakeWriting: string 
CakeWritingTooLong: bool 
private ActualLength: int 

private methods: 
CalculateCostOfDecorations() 
CakeSizef) 
MaxWritingLength() 


class BirthdayParty 

{ 

public const int CostOfFoodPerPerson = 25; 
public int NumberOfPeople { get; set; } 

public bool FancyDecorations { get; set; } 
public string CakeWriting { get; set; } 

public BirthdayParty(int numberOfPeople, 


W\\cy\ the Biv-thdayPa\rty objed-t 

is mrtializjcd, rt *to kr\oy/ 
the r\umbcv o-f people, 七 he k'md 
dcdova*tiohS, diY\d the 
oy\ 七 he dake ； so i*b star 七 ou 七 

y/i*th tdkt dost 

r — 一 


bool fancyDecorations, string cakeWriting) 


NumberOfPeople = numberOfPeople; 
FancyDecorations = fancyDecorations 
CakeWriting = cakeWriting; 



The ^orvs-t\rud*tov sc*ts up "the 

K objcd^s s-taic by 

•the so 七 hat it 

tav\ dakulaie tos-t laicv-. 

Y 0[a II add this C^kdAAri 七 ’mg p\ropcv*ty 
oh 七 he hcx.-t page. 
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* You’ll need a CakeWriting string property to hold the writing on the cake. Its get 
accessor just returns the contents of a backing field called cakeWriting. 

* The CakeWriting set accessor first sets the cakeWriting field. Then it checks 
to see if the writing is too long and sets the actual Length field so it matches the 
actual number of letters added to the cake. 

* The CakeWriting set accessor needs to know the size of the cake (which varies 
based on the number of people) and the maximum number of letters that will fit on 
the cake (based on the cake size). You’ll add two methods to calculate these things. 

private int ActualLength 




V>c -r? 

—W 丁 

or^i ^ as a 

tabulates 

-to ^ ^ } 

6a\6iA\at»ov\. 


get 

{ 



l-f 七 he y/v-itmg is -too \ov\^ 
(or 七 he cake, the fv-ivatc 

pv-opc\rty 

dakulatcs 七 he adiual 

^urwbcv- o( lettev-s -that 
will U oy\ the dake- 


if (CakeWriting.Length > MaxWritingLength () 
return MaxWritingLength(); 


else 


return CakeWriting.Length; 


a 



Did you how 

wc Ic-Pt out sor^c o-p 
the bv-a^kets? l/Vhch 
you ohly have o^e 
S'tcl'tcrwCh't \v\ S todt 
blodk, you doh’t v\ttd 

■to add ^uv-ly bv-a^kets 
3\rouhd it. 


private int CakeSize() { 

if (NumberOfPeople <= 4) 
return 8; 

else 

return 16; 


This i-f /else blo^k 
Ac 乙 ks {\\t 1 ⑼咖 
of {\\t 

ar\d updates i\\t 

a^bualL ⑶办 

lc*b"bcv*s Will f 丨七 

OY\ the dakc. 



private int MaxWritingLength() 

{ 

if (CakeSize() == 8) 
return 16; 

else 

return 40; 




OW Watkcfe arc 呷 W k blo^s 

a 1 。“ w 一一 “ : 匕工 1 e 以 

slatcmc^ msidc its blo6k. ^ t a I ^ ^ V o U avoid 

^ - lid ^ u a ' 00? ；；' aft " y) 

w, 二 m ㈣ 

poT^cOobfOj 一 
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kathleen’s gonna love this 


Keep on going with the BirthdayParty class... 


w 


★ Finish off the BirthdayParty class by adding the Cost property. But instead of 
taking the decoration cost and adding the cost of beverages (which is what happens 
in DinnerParty), it’ll add the cost of the cake. 

/ This PvoPevtv vctuv^s tvuc \( js -too ^ ^ 

take. Wt\\ use \i io display a 认 TOO LO^ m 议 ay 心祕⑼ • 

public bool CakeWritingTooLong 


get 

{ 


if (CakeWriting.Length > MaxWritingLength()) 
return true; 


else 


return false 



This pvopev-ty or\|y has a 3e 七 
addessov, because i*t doesn't 
七 he sta*tc o( -the objcd*t a*t all- li 

jus*t uses *thc -fields dr\d methods 
•to ddkuld*be a bool value- 


private decimal CalculateCostOfDecorations() - 


decimal costOfDecorations; 
if (FancyDecorations) 

costOfDecorations = (NumberOfPeople * 15.00M) + 50M; 

else 

costOfDecorations = (NumberOfPeople * 7.50M) + 30M; 
return costOfDecorations; 


This nr\C*thod is jus*t like *thc OY\t 
•m *thc D*m^c\rPav-ty dldss. 


public decimal Cost 


get 

{ 


decimal totalCost = CalculateCostOfDecorations(); 
totalCost += CostOfFoodPerPerson * NumberOfPeople; 
decimal cakeCost; 
if (CakeSize() == 8) 

cakeCost = 4OM + ActualLength * 

else 

cakeCost = 75M + ActualLength * 
return totalCost + cakeCost; 


Bir^daYPartY tlass has 
f a dcdimal Cost >st 

\y |*,kc Pi 滅 rParb/. Bu 七 rt does 

a daltulatio^ 

uses CakeW) me 七 W ad 

“ 比 W is sc*t 

by i\\t CakeiAMti% ^o^rty). 


25M, 


25M, 




R» ? bade a 州 e ad take a closer look a-t 
Kov/ CakdAMt— ?vo?crtv sets 

^ 1^ IS 
lo^ U dakc, i-t sc-b adWU^ to 
“ d leUers ^ anally ^ - 
dakc. Out tV.c maximum 

le % 仏 dost stop 30^5 u\>. 
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Clitk oy\ the tabs {jo 


USB A TasConr^oi JO ADD TABS JO THE FOEM- 

Drag a Tab Control out of the toolbox and onto your form, and 
resize it so it takes up the entire form. Change the text of each 
tab using the TabPages property: a “•••’’ button shows up in the 
Properties window next to the property. When you click it, the IDE 
pops up a window that lets you edit the properties of each tab. Set the 
Text property of the tabs to “Dinner Party” and “Birthday Party”. 


PASTE THE &INMBE PAETY CObiWOUS ObiTO THBIE TAB. 


七 1 化 州 . Use 
i\\c TabPages -to 

the 七 wt -fov cadh 
■tab. C\\ck *thc w ... w button 
-to it arvd st\cd 
tab's pvofc\rty. 


■_ 

n 5 Party Planner2.0 


Dinner Party 

Birthday Party 



Open up the Party Planner program from Chapter 5 in another 
IDE window. Select the controls on the tab, copy them, and 
paste them into the new Dinner Party tab. You’ll need to 
click inside the tab to make sure they get pasted into the right 
place (otherwise you’ll get an error about not being able to add a 
component to a container of type TabControl). 

One thing to keep in mind here: when you copy and paste a control 
into a form, you’re only adding the control itself, not the event 
handlers for the control. And you’ll need to check to make sure 
that (Name) is set correctly in the Properties window for each of 
them. Make sure that each control has the same name as it did in 
your Chapter 5 project, and then double-click on each control after 
you add it to add a new empty event handler. 



A-PW you Pi ⑽伙 

pavty £-o^*tvols oir>*to 
^ c y ; || o^ly be visible 

Pav-ty -tab is selected. 


O SUIUD THE BIETHDAY PAETY USEE INTBEFACB. 

The Birthday Party GUI has a NumericUpDown control for the number of people, a 
CheckBox control for fancy decorations, and a Label control with a 3D border for the cost. 
Then you’ll add a TextBox control for the cake writing. 


餐 


TWis -tab uses i\\t 

Kumcv*idU\>Po>wy>, ! Number of People 

diY\d Label wbroU jus 七 like ^ ^ 

-tv>c P*mr>cv- Pav-tY -tab docs. 

"bV>Cm r>umbcv*B*i\rtV>d3Y 

biv ■七 V>daYCost. 


o 


^ Party Planner 2... 


Dinner Party 


Birthday Par 



Fancy Decorations 


Cake Writing 



Add a Label Edited "tooLoh^Lcibd that has 

the tex-t TOO LOH^ b ved bddk^v-ouhd 



Clidk oh the Birthday Pav-ty 
3hd 3idd *thc hCw doh*t\rols. 


Add a 7cx*tBox doh*t\rol ts\\td 
^kclVHtihg 4\r the wvitmg 
Oh the dakc (a^d a label above 
’|七 so "the usev khows what it's 
*Po\r). Use i*ts 7cx*t pV"opcv**ty 

^ 3 iv c it a default value 
“Wappy Bi\rthday w . 
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finish the ^orm 


Keep on going with the code for the form... 

O PUT IT AUU T^BTHBE. 

All the pieces are there — now it’s just a matter of writing a little code to make the controls work. 



* You’ll need fields in your form that have references to a BirthdayParty object and a 
DinnerParty object, and you’ll need to instantiate them in the constructor. 

* You already have code for the dinner party controls’ event handlers — they’re in your 
Chapter 5 project. If you haven’t double-clicked on the NumericUpDown and CheckBox 
controls in the Dinner Party tab to add the event handlers, do it now. Then copy the 
contents of each event handler from the Chapter 5 program and paste them in here. Here’s 
the code for the form: 


public partial class Forml : Form 
DinnerParty dinnerParty; 
BirthdayParty birthdayParty; 
public Forml() { 

工 nitializeComponent(); 



TV Birt^daYParty msta^c is 

mi-bializ^d m tiiC \orvr!s tor\s*bv-uC.*tov- ) 
just like tVic PmncvPavty. 


dinnerParty = new DinnerParty((int)numericUpDownl.Value, 

healthyBox.Checked, fancyBox.Checked); 
DisplayDinnerPartyCost(); 


birthdayParty = new BirthdayParty((int)numberBirthday.Value, 

fancyBirthday.Checked, cakeWriting.Text); 
DisplayBirthdayPartyCost(); 

} 

// The fancyBox, healthyBox r and numericUpDownl event handlers and 
// the DisplayPartyDinnerCost () method are identical to the ones in 
// the Dinner Party exercise at the end of Chapter 5• 


* Add code to the NumericUpDown control’s event handler method to set the object’s 
NumberOf People property, and make the Fancy Decorations checkbox work. 


private void numberBirthday ValueChanged(object sender, EventArgs e) 


birthdayParty.NumberOfPeople = (int)numberBirthday.Value; 

} DisplayBirthdayPartyCost (); ^ The ChtMo% 3hd 

av-c jus-t like the ohes (or the dmw pavty. 

private void fancyBirthday CheckedChanged(object sender, EventArgs e) 


birthdayParty.FancyDecorations = fancyBirthday.Checked; 
DisplayBirthdayPartyCost (); 
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Use the Events page in the Properties window to add a new 
TextChanged event handler to the cakeWriting TextBox. Click 
on the lightning bolt button in the Properties window to switch to the 
Events page. Then select the TextBox and scroll down until you find the 
TextChanged event. Double-click on it to add a new event handler for it. 


Properties 


ca keW riting System .Wind owi. Forms.TediBoK 





TextAlignChanged 


▲ 


TextChanged 


ca keWriti ng_TextCha nged 



VisibleChanged 


▼ 


l/Vhch you select the 

double—dlidk oy\ 七 he 
Tc^tClia^jcd vow m 
the Events page c^P the 
Pv-opcirtics W\Y\do>N, 七 he 
IPE y/ill add a how cvcht 
ha^dlcv -that jets -fiv-cd 
cvev-y -time 七 he m 

七 he \>o% 


private void cakeWriting_TextChanged(object sender 

{ 

birthdayParty.CakeWriting = cakeWriting.Text; 
DisplayBirthdayPartyCost(); 

} 


EventArgs e) 





* Add a DisplayBirthdayPartyCost () method and add it to 
Co^tv'ols V^dve d all of the event handlers so the cost label is updated automatically 
Visible fvopev-by any time there’s a change. 

i\\ai causes 从加 Birt^dayPavly tlass closes i\\\s - 

•to appear oirt ov pvofcvty so dan display a 

disappcav- -fvom 

-rovm \ Private void DisplayBirthdayPartyCost () { 

V_^J^tooLonqLabel.Visible 二 birthdayParty.CakeWritingTooLong; 
decimal cost = birthdayParty.Cost; 
birthdayCost.Text = cost.ToString("c"); 


f[\\ -the micll'ijc^dc (o\r dcal'm^ v/rth 七 he >w\rrtm 少七 V>C 
number o( fcoflc, dr>d i\\t dakc s\z^ IS built *m*to i\\t 
Kumbcv-0-fPcoplc av\d Cakcl/Vvitm^ sc*t autssors, so 
•fovm jus*t V>3s *to set dis^lsy values. 

...and you’re done with the form! 


The >way 七 ha 七七 he -fovm 
handles *thc dakc 
ddv> be v-cally simple because 
i\\t B*iv-*thdayPa\rty dlass 
is v/ell cy>dafsula*tcd. AH 
-fovm ii3s *fco do is use 

rts torrbroU *to sc*t 七 he 
pvopcvtics oy \ object 
av>d ob\cd*t takes dav-c 
Jc 七 he vest- 
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it fives! 


% 




O PE^EAM X S TO EUM ITi 

Make sure the program works the way it’s supposed to. Check that it 
pops up a message box if the writing is too long for the cake. Make sure 
the price is always right. If it’s working, you’re done! 


□□ 


Party Planner 2... 



Dinner Party 


Birthday Party 


Number of People 


5 


0 Fancy Decorations 
I Healthy Option 


Cost $350.00 


Clidk or> Bi^rthday pa^rty lab. 
Make suve 七 he dos 七 
you y>umbcv- fcoflc 

ov- tl'idk the Pay>dy Pcdo\ra*t*ioir>s 
dKcdkbo%. 


a 9 Party Planner 2... 



Dinner Party 


Birthday Party 


Number of People 


4 


@ Fancy Decorations 
Cake Writing X 


Happy Birthday Myrtle 


Cost $254.00 


Stairt up -the pv-oyarw a 灼 d 30 七 o 

the Diirmev* Rav-ty tab. Make suve 
iha-t it wovks just like youv old 
Pav-ty Pla^cv- pv-oya^. 



€ Party Planner 2... 



Dinner Party 


Birthday Party 


Number of People 


5 


Fancy Decorations 


Cake Writing 


Happy Birthday 


Cost $328.50 
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l/VWh you type ih -the Cake iVv-i-tmg 
七 ex 七 box, "the 7 cx"tCli 3 h^cd cvch*t 
^>3^dlcv* should "the £.os*t cvcv*y 

"tirwe you sdd ov \rcmovc a Icttcv-. 


I*P "the wvitmg is -fcoo loh^ 

-pov- the the Bi\rthdayPolv-ty 
dldss sets i*ts C3kdA/v*i"( ： ih^7ooL-oh^ 
p\ropc\rty -to -t\ruc ahd ^akulaies 
the Cosi with the maximum |< 

丁 he -Povrw docsh ； *t heed "to do 

^akulatioh at all. 



Poes tal^la-tion wov-k 
CorYtt{\^ k tV)is tasC) \0 
fcofle mca^s jvy per 
(fZ^O) flus ^ a 1^ 
take plus jl^O fev 

*fov- *tV)C 灼 cm - 

dc^ov-atio\r\s plus a 
dedovatmj -fee fWs \>cv 
Ic-tW -fov- Vi Ic-t'tc'rs oy\ -tV^c 
ddke (/ 弓 2- 弓 ). 


So jV^O + + + 

+ f’U 弓二 / 杉 m I 七 v/orksf 



«? Party Planner 2... 



□nner Party 


Birthday Party 


Number of People 


ia 


I I Fancy Decorations 
Cake Writing 


Happy Birthday r^yrtle 


Cost S435.25 


% 
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Owe more thmg...can you add a ” 00 fee 
for parties over 12? 

Kathleen’s gotten so much business using your program that she can afford 
to charge a little more for some of her larger clients. So what would it take to 
change your program to add in the extra charge? 

* Change the DinnerParty. Cost property to check 
NumberOf People and add S100 to the return value if it’s over 12. 

* Do the exact same thing for the BirthdayParty. Cost property. 

Take a minute and think about how you’d add a fee to both the 
DinnerParty and BirthdayParty classes. What code would you write? 
Where would it have to go? 

Easy enough.. .but what happens if there are three similar classes? Or four? Or 
twelve? And what if you had to maintain that code and make more changes 
later? What if you had to make the same exact change to five or six closely 
related classes? 



VO^VU, HAVB lO WRITB 
THB SAMB COt>B 
AND A^AIM. THAT^ A 

RBAUUY INBFFI6IBMT VJfiC/JO 

&OI TO BB 

A BBTTBR WAY/ 


You’re right! Having the same code repeated in 
different classes is inefficient and error-prone. 

Lucky for us, G# gives us a better way to build classes that are 
related to each other and share behavior: inheritance. 


you are here ► 


247 




no need to use gold when anything shiny will do 


Whew your classes use mheritawee, you only 
need to write your code once 


It’s no coincidence that your DinnerParty and BirthdayParty classes have 
a lot of the same code. When you write G# programs, you often create classes that 
represent things in the real world — and those things are usually related to each other. 
Your classes have similar code because the things they represent in the real world — a 
birthday party and a dinner party — have similar behaviors. 


y/Ka*t kmd 
parties *tKcy av-c. 


"bo -figure out 
dos*t o-f K 


_DinnerParty 

NumberOfPeople ^ - 

FancyDecorations < 

Cost < - - - 

HealthyOption 

^ CalculateCostOfDecorations() 

(CalculateCost 

OfBeveragesPerPersonf) 





BirthdayParty 


NumberOfPeople 
FancyDecorations 
Cost 

CakeSize 

CakeWriting 

CalculateCostOfDecorations() 

CakeSizef) 

MaxWritingLengthf) 


A bi\rthday paviy 
h^hdlcs humbev 


people ahd the 
ih almost same 


way as a dihhev- 
fa\rty. 


Pinner parties and birthday parties arc both parties 

When you have two classes that are specific cases of something more general, 
you can set them up to inherit from the same class. When you do that, each of 
them is a subclass of the same base class. 
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Puild up your class model by starting general 
and getting more specific 

G# programs use inheritance because it mimics the relationship that the things 
they model have in the real world. Real-world things are often in a hierarchy 
that goes from more general to more specific, and your programs have their 
own class hierarchy that does the same thing. In your class model, classes 
further down in the hierarchy inherit from those above it. 


General 



Food 


U a dUss model 
Cheese mi # 七 
-fvom 

y/ould 
-firom Pood- 


General 


^vcv"Y Wd 

a 灼 “al，bu 七於。七 cvcv"Y 

dirndl is a Wd. 


Dairy Product 



Animal 


Bird 


Cheese 


Cheddar 


To somcohc lookihg ^ a p c ^ 

广 y —hi da Bui 

°^olo d isi siudyM 

^^usih 9 ih c 

如 d Souihcirh modkihjbi^ds 

would be Uhaddcp^blc. 


Songbird 


Mockingbird 


Aged Vermont Cheddar 


Specific 

you have a that ca\\s 
^ ov * ^^eddav- dheese, *thch you 
Uh use aged dhedda^. 

BuH 七 spcdi-fidally heeds ayd 
l/c^rmoht, thch you just 
use ahy dheddav-—you heed -that 
spcdi-Pid dhccsc. 


u Northern Mockingbird 

SomctKm^ lov/CV- Wizard) 

mosW all oUk atViW-tcs ⑽价 ” Specific 
above it All animals cat a^d mat ”。 

KovlKcv-^ /Vlodkm^bivds cat 3r>d 


a 七 c. 


in_her_it ， verb. 

to derive an attribute from one，s 
parents or ancestors. She wanted the 
baby to ifihevit her big brown eyes^ 
ctTid not hev husband’s beady blue ones. 
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it’s a zoo in here 


How would you design a zoo simulator? 

Lions and tigers and bears...oh my! Also, hippos, wolves, and the 
occasional cat. Your job is to design a program that simulates a zoo. (Don’t 
get too excited — we’re not going to actually build the code, just design the 
classes to represent the animals.) 

We’ve been given a list of some of the animals that will be in the program, 
but not all of them. We know that each animal will be represented by 
an object, and that the objects will move around in the simulator, doing 
whatever it is that each particular animal is programmed to do. 


More importantly, we want the program to be easy for other programmers 
to maintain, which means they’ll need to be able to add their own classes 
later on if they want to add new animals to the simulator. 

So what’s the first step? Well, before we can talk about specific animals, 
we need to figure out the general things they have in common — the 
abstract characteristics that all animals have. Then we can build those 
characteristics into a class that all animal classes can inherit from. 


The terms parent, 
superclass, and base 
class are often used 
interchangeably. Also, 
the terms extend and 
inherit from mean the 
same thing. The terms 
child and subclass 
are also synonymous, 
but subclass can also 
be used as a verb. 

/ 

Some people use the tcv-rw u basc 
class'' -to spc^i-Pi^lly the dass 

the "top of -the 
■bree.Hot 七 |^ -fcoP, 

CVC^ry dass *mhcv-its 
0\)^cd o\r a subclass o( Object 


O \^OOK THINGS TH5 ANIMALS HAVE IN 




Take a look at these six animals. What do a lion, a hippo, a tiger, a cat, a 
wolf, and a dog have in common? How are they related? You’ll need to 
figure out their relationships so you can come up with a class model that 
includes all of them. 
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Use inheritance to avoid duplicate 
code m subclasses ❺ 

You already know that duplicate code sucks. It’s hard to maintain, and 
always leads to headaches down the road. So let’s choose fields and 
methods for an Animal base class that you only have to write once, 
and each of the animal subclasses can inherit from them. Let’s start with 
the public fields: 

* Picture: an image that you can put into a PictureBox. 

* Food: the type of food this animal eats. Right now, there can be only 
two values: meat and grass. 

* Hunger: an int representing the hunger level of the animal. It 
changes depending on when (and how much) the animal eats. 


BUIUD A BASE 6UASS 
TO 多 IN/5 TH5 ANIMALS 
BVBlzrrHIN^ THEY HAVE 
IN CO/^AObi. 

The fields, properties, and methods 
in the base class will give all of 
the animals that inherit from it 
a common state and behavior. 
They’re all animals, so it makes 
sense to call the base class Animal. 


* Boundaries: a reference to a class that stores the height, width, and 
location of the pen that the animal will roam around in. 

* Location: the X and Y coordinates where the animal is standing. 

In addition, the Animal class has four methods the animals can inherit: 

* MakeNoise ( ) : a method to let the animal make a sound. 

* Eat () : behavior for when the animal encounters its preferred food. 

* Sleep () : a method to make the animal lie down and take a nap. 

* Roam () : the animals like to wander around their pens in the zoo. 


Animal 


Picture 
Food 
Hunger 
Boundaries 
Location 

MakeNoise() 

Eat() 

Sleep() 

Roam() 




CV^oosm^ 3 kasc \s 
about Voltes. You 

^ould Kavc deeded *to 

use 3 da ss 

七七 dc-f'mcs W\t -feed 
dhd 乙 os*ts> 

or tlass 

y/i-tK mc*tKods -fov- W 

zjoo v'is'i*tov*s. >mc *tWmk 

makes i\\t most 

scy\sc Kcvc. Po Y ou 3^v*cc? 
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warning: don’t feed the programmers 


Piffcrewt animals make different noises 


Lions roar, dogs bark, and as far as we know hippos don’t 
make any sound at all. Each of the classes that inherit from 
Animal will have a MakeNoise () method, but each of those 
methods will work a different way and will have different code. 

When a subclass changes the behavior of one of the methods 
that it inherited, we say that it overrides the method. 

❺ 

think about what you need to override 

Every animal needs to eat. But a dog might take little bites 



Just because d fv-ofev-ty or d 
•, s m i\\t /Wal base c\ass t i\\ai 
does 竹’七 cvcv-y subdlass Kas -to use 

\i same y/ay...ov- a*t allf 


FI^UEB OUT WHAT BACH 
ANIMAU l>OBS THAT TH5 
ANIMAU CLASS t>OBS 
DIFF6125NTLy-^12 N^>T AT AUU. 


of meat, while a hippo eats huge mouthfuls of grass. So what 
would the code for that behavior look like? Both the dog and 
the hippo would override the Eat () method. The hippo’s 
method would have it consume, say, 20 pounds of hay each 
time it was called. The dog’s Eat () method, on the other 
hand, would reduce the zoo’s food supply by one 12-ounce 
can of dog food. 


What does each type of animal do that 
all the other animals don’t? Dogs eat dog 
food, so the dog’s Eat () method will need 
to override the Animal. Eat () method. 
Hippos swim, so a hippo will have a Swim () 
method that isn’t in the Animal class at all. 



So you^vc yt a subdlass 
七 ha 七 mhcv-i*U -Pv-om a base 
tlass, i*t mus 七 'mhcv-'it d\\ o( 


-the base dass’s bchaviovs... 
bu*t you modi-fy *m 
-the subclass so *tV>cyVc y \ o {, 
pcv*-Pov*mcd c^3d*tly same 
v/ay. Tha*t’s >wha*t ovc\r\ridir>^ is 
all about 


Animal 

Picture 

Food 

Hunger 

Boundaries 

Location 


MakeNoise() 

Eat() 

Sleep() 

Roam() 



We already know that some animals will override the 
MakeNoise () and Eat () methods. Which animals will 
override Sleep () or Roam () ? Will any of them? What about 
the properties — which animals will override some properties? 


252 


Chapter 6 













inheritance 


Thiwk about how to group the animals 

Aged Vermont cheddar is a kind of cheese, which is a dairy product, which is 
a kind of food, and a good class model for food would represent that. Lucky 
for us, C# gives us an easy way to do it. You can create a chain of classes that 
inherit from each other, starting with the topmost base class and working down. 
So you could have a Food class, with a subclass called DairyProduct that 
serves as the base class for Cheese, which has a subclass called Cheddar, 
which is what AgedVermontCheddar inherits from. 


O \^OOK 6UASS5S THAT 
HAVE A U?T IN 

Don’t dogs and wolves seem pretty similar? 
They’re both canines, and it’s a good bet 
that if you look at their behavior they have a 
lot in common. They probably eat the same 
food and sleep the same way. What about 
domestic cats, tigers, and lions? It turns out 
all three of them move around their habitats 
in exactly the same way. It’s a good bet that 
you’ll be able to have a Feline class that 
lives between Animal and those three cat 
classes that can help prevent duplicate code 
between them. 


Animal 


Picture 

Food 

Hunger 

Boundaries 

Location 



Theme s s p\re*tty 

9°^ -that 
II be able -to add 
a Cahihc class -tha-t 
the dogs ahd wolves 
both ihhcHt 4or^. 
r^ay have 

behavior i h c.0^0^, 
,ikc 小 epih 3 i h dehs. 


The subclasses 

a\\ -fouv- 

methods -fv-om 

bui 

so -fav- wcVc 
only havih^ 
xhem ovevv-ide 
MskcHoiscO 3hd 
BaiO. 


七 s why y/C 
only show "those 
"bw。methods ih 
七 he ^lass dia^a^s 


Wha 七 v/ouldi rb look like i-f 3ddcd 
a SwimO method *to Hiffo dlass? 
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extend your objects 


Create the class hierarchy 

When you create your classes so that there’s a base class at the top with 
subclasses below it, and those subclasses have their own subclasses that 
inherit from them, what you’ve built is called a class hierarchy. This is 
about more than just avoiding duplicate code, although that is certainly 
a great benefit of a sensible hierarchy. But when it comes down to it, the 
biggest benefit you’ll get is that your code becomes really easy to understand 
and maintain. When you’re looking at the zoo simulator code, when you see 
a method or property defined in the Feline class, then you immediately know 
that you’re looking at something that all of the cats share. Your hierarchy 
becomes a map that helps you find your way through your program. 

O FINISH y^>U12 CLASS HIBEAECHy. 

Now that you know how you’ll organize the animals, 
you can add the Feline and Canine classes. 


Animal 

Picture 
Food 
Hunger 
Boundaries 
Location 

MakeNoise() 
Eat() 

Sleep() 
Roam() 


Dog 

objects hdve 
the same 
and slccpihj 
behavior but make 
di-Pfcv-Cht hoiscs. 


Smtc Fcl'mc ovcv-v-'idcs RoamO, 

i*ts Rodw»() 3ir\d 
七 he o\r\C m 



The -thvee cah ih e 

⑽ t ，的 ihey shave 

ah … Roa 你 () 

Bu-t Ohc 

J.II wk es _ 

d'+Wh-tly, so Ueyil a || 

mTu C Bai0 ^ 

^lakcA/cscO methods 

ihhcHtcd M 

“I. 
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inheritance 


Every subclass extewds its 
base class 

You’re not limited to the methods that a subclass inherits 
from its base class.. .but you already know that! After all, 
you’ve been building your own classes all along. When you 
add inheritance to a class, what you’re doing is taking the 
class you’ve already built and extending it by adding all of 
the fields, properties, and methods in the base class. So if you 
wanted to add a Fetch () method to Dog, that’s perfectly 
normal. It won’t inherit or override anything — only Dog 
objects will have that method, and it won’t end up in Wolf, 
Canine, Animal, Hippo, or any other class. 


hi-er - ar-chy ， noun. 

an arrangement or classification 
in which groups or things are 
ranked one above the other. The 
pfesideut of Dyucanco had wofked 
his way up f totr the tyicliItootyi to the 
top of the corporate hierarchy. 


Dog spot = new Dog() 


spot.MakeNoise(); 


makes a Dog objed-t 

ddlls version \ y \ Dog 


td\\s version 


dalls version'm 


dalls version *m 


ddlls version *m Dog 


always calls the most specific method 

If you tell your dog object to roam, there’s only one method that can 
be called — the one in the Animal class. But what about telling your 
dog to make noise? Which MakeNoise () is called? 

Well, it’s not too hard to figure it out. A method in the Dog class tells 
you how dogs do that thing. If it’s in the Canine class, it’s telling you 
how all canines do it. And if it’s in Animal, then it’s a description of 
that behavior that’s so general that it applies to every single animal. So 
if you ask your dog to make a noise, first G# will look inside the Dog 
class to find the behavior that applies specifically to dogs. If Dog didn’t 
have one, it’d then check Canine, and after that it’d check Animal. 


spot.Roam(); 


spot.Eat(); 


spot.Sleep() 


spot.Fetch() 


Animal 


Picture 

Food 

Hunger 

Boundaries 

Location 


MakeNoise() 

Eat() 

Sleep() 

Roam() 




纖 
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base: how low can you go? 


Use a colon to inherit from a base class 

When you’re writing a class, you use a colon (:) to have it inherit from 
a base class. That makes it a subclass, and gives it all of the fields, 
properties, and methods of the class it inherits from. 


Vertebrate 





Bird 

Wingspan 


FlyO 



twenty is ah ihs-bhdc 
so i*t ； s jo*t 
Bi\rd methods — 

-fields as usual. 


Dumb 


e no o 

Questions 


class Vertebrate 
{ 

public int NumberOfLegs; 
public void Eat () { 

// code to make it eat 

} 

} Kc dlass uses a 6oU {p •“ … 七 心 0 ' 气 £ 

二—十 ml . 

fields, 七： 咖 e 

class Bird : ^Vertebrate 


Wlien a subclass 
inkerits from a 
Lase class，all 
ol tke lielcts ， 
properties, and 
metkocts in tke 
Lase class are 
automatically 
adctect to tke 
subclass. 


public double Wingspan 
public void Fly() { 

// code to make the bird fly 

} 


/ou ihhevit a class by 
dddih^ a doloh -to the Chd 
the dlass dct\a^ahoY\, 
•followed by the base class 
io ihhevit -P\rom. 


public buttonl_Click(object sender, EventArgs e) { 

Bird tweety = new Bird(); 

Wingspan = 7.5; C* m /# mV>CV"»*ts 

.ty.KiyO; 

tweety.NumberOfLegs = 2; 7 _ also V>as 

tweety. Eat () ; ^y\A methods dc-fmed »v\ 


\tweet 
I tweet 


Why does the arrow point up, from the subclass to the 
base class? Wouldn’t the diagram look better with the arrow 
pointing down instead? 

A! It might look better, but it wouldn’t be as accurate. When you 
set up a class to inherit from another one, you build that relationship 
into the subclass—the base class remains the same. And that makes 
sense when you think about it from the perspective of the base class. 


Its behavior is completely unchanged when you add a class that 
inherits from it. The base class isn’t even aware of this new class 
that inherited from it. Its methods, fields, and properties remain 
entirely intact. But the subclass definitely changes its behavior. Every 
instance of the subclass automatically gets all of the properties, fields, 
and methods from the base class, and it all happens just by adding a 
colon. That’s why you draw the arrow on your diagram so that it’s part 
of the subclass, and points to the base class that it inherits from. 
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inheritance 


c^^rpen your pencil 


Take a look at these class models and declarations, and then 
circle the statements that won’t work. 


Aircraft 

AirSpeed 

Altitude 


TakeOff() 

Land() 



class Aircraft { 

public double AirSpeed; 
public double Altitude; 
public void TakeOff() { ... }; 

public void Land() { ... }; 


class FirePlane : Aircraft { 

public double BucketCapacity; 
public void FillBucket() { ... }; 


FirePlane 


BucketCapacity 


HI 旧 ucket() 


public void FireFightingMission() { 

FirePlane myFirePlane = new FirePlane (); 
new FirePlane.BucketCapacity = 500; 
Aircraft.Altitude = 0; 
myFirePlane.TakeOff(); 
myFirePlane.AirSpeed = 192.5; 
myFirePlane.FillBucket(); 

Aircraft.Land(); 


Sandwich 

Toasted 

SlicesOfBread 


CountCaloriesQ 



BLT 


SlicesOfBacon 

AmountOfLettuce 


AddSideOfFriesQ 




class Sandwich { 

public boolean Toasted; 

public int SlicesOfBread; 

public int CountCalories () { ... } 


class BLT 
public 
public 
public 


: Sandwich { 
int SlicesOfBacon; 
int AmountOfLettuce; 
int AddSideOfFries() 


public BLT OrderMyBLT() { 

BLT mySandwich = new BLT (); 

BLT.Toasted = true; 

Sandwich.SlicesOfBread = 3; 
mySandwich.AddSideOfFries(); 
mySandwich.SlicesOfBacon += 5; 

MessageBox.Show("My sandwich has " 

+ mySandwich.CountCalories + "calories."); 
return mySandwich; 
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I can think of one way to make a penguin fly... 


c^^rpen your pencil 


Take a look at these class models and declarations, and then 
circle the statements that won’t work. 


Aircraft 

AirSpeed 

Altitude 


TakeOff() 

LandQ 



FirePlane 


BucketCapacity 


RNBucketO 


class Aircraft { 

public double AirSpeed; 
public double Altitude; 
public void TakeOff() { 
public void Land() {.. 



class FirePlane : Aircraft { 

public double BucketCapacity; 
public void FillBucket() {.. 


public void FireFightingMission() 

FirePlane mvFirpPlane = new FirePlane () 
FirePlane . BucketCapacity = 50 U 
CAircr^'f t .^Altitude 


TWs hot how 


you use 


cywoird. 



myFirePlane.TakeOff() 
myFirePlane.Airspeed = 192.5 
myFirePlane.FillBucket(); 
C^i'rcratt. Land (") ；_ 


二 ㈣ 於 

oUW 


Sandwich 

Toasted 

SlicesOfBread 


CountCaloriesQ 


7 

\ 

BLT 


SlicesOfBacon 


AmountOfLettuce 


AddSideOfFriesQ 


class Sandwich { 

public boolean Toasted; 
public int SlicesOfBread; 
public int CountCalories() 


class BLT : Sandwich { 

public int SlicesOfBacon; 
public int AmountOfLettuce; 
public int AddSideOfFries() 


public BLT OrderMyBLT() { 

BLT my. Sandwich = new BLT() 
BLT.Toasted = true; 

S_andwich. SlicesOfBread = 3; 
my Sandwich . A3ciS_LcieUli , ri^s (T 
mvSandwich.SlicesOfBacon += 


TKcsc arc ^ 

• ，以 a 你 Wt ^ avc 

bo tall 

usm^ 6lass ^ames. 


5; 


MessageBox.Show("My sandwich has 

mySandwich.CountCalories + "calories. n ) 

rpf'tTTH^iriHwi r.h - - 
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inheritance 


Wc know that mheritance adds the base class 
fields, properties, and methods to the subclass... 


Inheritance is simple when your subclass 
needs to inherit all of the base class 


methods, properties, and fields. 


P'i^cov> d 
subclass 

so awy -f ields av>d 
w\c*t^ods m 
avc au'bowS't'^sIlY 

-too. 



•but some birds don't fly! 


class Bird { 

public void Fly() { 

// here A s the code to make the bird fly 

} 

public void LayEggs() { .. . }; 

public void PreenFeathers() { ... }; 


class Pigeon : Bird { 

public void Coo() { ... } 


class Penguin : Bird { 

public void Swim() { ... } 


What do you do if your base class has a 
method that your subclass needs to modify^ 

.y is i 於 ta h 々 



Sihdc i-t 
'^hcHicd ihc RyO 

仏 od, iheves ho-thiha 

^PP^9 ii fly ih9 . 


public void BirdSimulator() { 

Pigeon Harriet = new Pigeon(); 
Penguin 工 zzy = new Penguin(); 
Harriet.Fly(); 

Harriet.Coo(); 

Izzy•Fly(); 



Bo*tK 

bo*tK <\c*t 





a " d 

二七 w SO 



i\\Cj boW y 七七 he 
plyO, Layt^sO, av\A 
Pv-ccy\Fca*tKcv-sO methods. 

^ 9u !T s houldh ； t be able h> W 

Pch 9 uih dass Bi^d, 

|| ， P 呼 …“ ly 中 II 晰 the 

plaa So what do WC do? 





If this were your Bird Simulator code, what would 
you do to keep the penguins from flying? 
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manual override 


A subclass caw override methods to change 
or replace methods it mherited 

Sometimes you’ve got a subclass that you’d like to inherit 
most of the behaviors from the base class, but not all of them. 

When you want to change the behaviors that a class has 
inherited, you can override the methods. 

o ADD THE VII2TUAU TO THE METHOD IN THE BASE fiUASS- 

A subclass can only override a method if it’s marked with the virtual keyword, which tells G# to 
allow the subclass to override methods. 

class Bird { 

public virtual "void Fly() { 

// code to make the bird fly 

} 

} 

Q ADD A METHOD WITH THE SAME NAME TO THE DERIVeD CLASS- 

You’ll need to have exactly the same signature — meaning the same return value and 
parameters — and you’ll need to use the override keyword in the declaration. 

class Penguin : Bird { ^ To the FlyO method, add 

ah idc ^ al ^od io the subclass 

public override void Fly () { use the ov e ^id g keyword. 

MessageBox• Show("Penguins can r t fly! n ) 

} 

} 

you ovcv-vidc 3 r^c*bhod, youv t\t^i 
^ti\\od ^ccds -to have same 

si^atuve as {Mt mc-thod i\\t base 
dass i*t’s ovcvvid'm^. \y\ 七 Wis C^st , 七七 

me 扣 S rb r^ccds bo be called Fly, 

Void ； ildVC V'O ^3V"3l^C"tcV"S. 



Use tke overricte key worct to 
add a metkoct to your subclass 
tkat replaces one tkat it 
inkerited. Beiore you can 
override a metkoct, you need to 
mark it virtual in tke base class. 



Addihg -the viv-fcual 

keyword ho ihc FlyO 
method tells C# that 
a s ^bdlass is allowed io 
override it 
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inheritance 


Awy place where you can use a base class, you 
caw use owe of its subclasses instead 

One of the most useful things you can do with inheritance is use a subclass in 
place of the base class it inherits from. So if your Recipe () method takes a 
Cheese object and you’ve got an AgedVermontCheddar class that inherits 
from Cheese, then you can pass an instance of AgedVermontCheddar to 
the Recipe () method. Recipe () only has access to the fields, properties, 
and methods that are part of the Cheese class, though — it doesn’t have access 
to anything specific to AgedVermontCheddar. 



Let’s say we have a method to analyze Sandwich objects: 


public void SandwichAnalyzer(Sandwich specimen) { 
int calories = specimen.CountCalories(); 
UpdateDietPlan(calories); 


Sandwich 

Toasted 

SlicesOfBread 


CountCaloriesQ 



BLT 


SlicesOfBacon 

AmountOfLettuce 


AddSideOfFriesQ 


PerformBreadCalculations(specimen•SlicesOfBread, specimen.Toasted); 


❻ 


You could pass a sandwich to the method — but you could also pass a BLT. Since a BLT is a kind of 
sandwich, we set it up so that it inherits from the Sandwich class: 



public buttonl Click(object sender, EventArgs e) { 


BLT myBLT = new BLT (); 
SandwichAnalyzer(myBLT); 


*talk about 七 Wis move 


You can always move down the class diagram —— a reference variable can always be set equal to an 
instance of one of its subclasses. But you can’t move up the class diagram. 



public button2_Click(object sender, EventArgs e) { 

Sandwich mySandwich = new Sandwich () ; You 63^ ass*i^y\ __ 

BLT myBLT = new BLT () ; va/idblc because d 

Sandwich someRandomSandwich ： 

BLT anotherBLT = mySandwich; 



myBLT; ^^^ is a k*md sandWidVv 

// < —— THIS WON"T COMPILE!!! 
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get a little practice 



MiXed 

Messages 


a = 6 56 
b = 5; ><^ 11 
a = 5; 65 


Instructions: 

1. Fill in the four blanks in the code. 

2. Match the code candidates to the output. 


A short C# program is listed below. One block of 
the program is missing! Your challenge is to match 
the candidate block of code (on the left) with 
the output — what’s in the message box that the 
program pops up — that you’d see if the block were 
inserted. Not all the lines of output will be used, 
and some of the lines of output might be used more 
than once. Draw lines connecting the candidate 
blocks of code with their matching output. 


class A { 

public int ivar = 7; 

public _ string ml() { 

return n A's ml,"; 

} 

public string m2() { 

return n A's m2,"; 

} 

public _ string m3() { 

return "A's m3,"; 


class B 


A 


public 


string ml() { 


return "B's ml. 


Code 

candidates: 


q += b . ml (); 
q += c . m2 (); 
q += a•m3(); 


q += c . ml (); 
q += c . m2 (); 
q += c•m3(); 


q += a.ml(); 
q += b•m2(); 
q += c•m3(); 





q += a2 .ml () ; ■% 
q += a2.m2(); > 
q += a2.m3 (); 」 


class C : B 
public 


return "C's m3. 


string m3() { 

+ (ivar + 6); 


} } the Chtvy poiht -Po\r the pvogv-ar^—it 

docs^i show a it just pops up a message box. 

class Mixed5 { 

public static void Main(string[] args) { 


Wiivt: thihk vcally kav-d about 
hat this I'rnc vcally ¥ntSy\s. 

Candidate code 
goes here 

(three lines) 


System.Windows.Forms.MessageBox.Show(q); 


A 

a = 

new 

A(); 

B 

b = 

new 

B ()； 

C 

c = 

new 

C ()； 

A 

a2 = 

=new C (); 



string q 


Output: 


A's 

ml , 

A 

B's 

ml , 

A 

A's 

ml , 

B 

B's 

ml , 

A 

B's 

ml , 

C 

A's 

ml, 

B 

B's 

ml , 

A 

A's 

ml , 

A 


s m2, C's m3, 6 

s m2, A's m3, 

s m2, C's m3, 6 

s m2, C's m3, 13 

s m2, A's m3, 

s m2, A's m3, 

s m2, C's m3, 6 

s m2, C's m3, 13 
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(Don’t just type this into the IDE — you’ll learn 
a lot more if you figure this out on paper!) 













inheritance 





Paa] Puzz]c 



Your job is to take code snippets from the pool and place them into 
the blank lines in the code. You may use the same snippet more 
than once, and you might not need to use all the snippets. Your 
goal is to make a set of classes that will compile and run together 
as a program. Don’t be fooled — this one’s harder than it looks. 


class Rowboat { 

public rowTheBoat() 

return "stroke natasha"; 


class 


private int 

void 


length = len; 


public int getLength() 


public 

return 


move () 


class TestBoats 


Wiht "this is -the 
CY\bry poih-t -fov- 
七 he p\rogv-a^. 


Main () { 

• xyz =""; 

bl = new Boat (); 

Sailboat b2 = new (); 

Rowboat = new Rowboat(); 

b2.setLength(32); 
xyz = bl• (); 

xyz += b3. (); 

xyz += .move(); 

System.Windows.Forms.MessageBox.Show(xyz) 


class 


: Boat 


public 

return 


0 { 


OUTPUT: 


drift drift hoist sail 
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get some practice 



MiXed 

Messages 


a 

b 

a 


6 ; 

5; 

5; 



class A 
SpLiitiPH public 


vi\rtual 


public 


viv-tual 


string ml() { 


string m3() 


You can always substitute a reference to a subclass in place of 
a base class. In other words, you can always use something 
more specific in place of something more general — so if 
you’ve got a line of code that asks for a Canine, you can 
send it a reference to a Dog. So this line of code: 

A a2 = new C(); 

means that you’re instantiating a new C object, and then - 

creating an A reference called a2 and pointing it at that object, q += a .ml () 
Names like A, a2, and C make for a good puzzle, but they’re q += b • m2 () 
a little hard to understand. Here are a few lines that follow the q += c • m3 () 
same pattern, but have names that you can understand: _ 


q += b.ml() 
q += c.m2() 
q += a.m3() 

q += c.ml() 
q += c.m2() 
q += c.m3() 


56 

11 

65 


class B 
public 

參 • • 

class C 
public 


Sandwich mySandwich = new BLT (); 

Cheese ingredient= new AgedVermontCheddar(); 
Songbird tweety = new NorthernMockingbird(); 


q += a2.ml() 
q += a2.m2() 
q += a2.m3() 


A { 

over ride 

B { 

ovew-ide 


string ml() 


string m3() 




A's ml, A's m2, C 
B's ml, A's m2, A 
A's ml, B's m2, C 
B's ml, A's m2, C 
B's ml, C's m2, A 
A's ml, B's m2, A 
B's ml, A's m2, C 
A's ml, A's m2, C 


s 


s 


s 


s 


s 


s 


s 


s 


P00] puzz]c 



class Rowboat:. ■ 
public 


.Boat.{ 

rowTheBoat () 


return "stroke natasha' 


class 


Boat 


private int 
fublid void 




m-t \cy\ ) { 




•le-ng-th = len; 


class TestBoats { 

Publid s*ba*ti^ void • Main () { 

xyz = ▼▼ ▼▼; 

Boat bl = new Boat (); 

Sailboat b2 = new Sailboat ()； 
Rowboat =new Rowboat(); 

b2.setLength(32); 
xyz = bl. W'OVC (); 

+= b3. move (); 

+= b2 - . move (); 


public int getLength() 


xyz 

xyz 


System.Windows.Forms.MessageBox• 


public 

return 

} 


victual 


move () 


class Sdilboai : Boat { 

public ovcv-v-idc move 


0 { 


return 


hois*t sail 


m3, 6 
m3 , 
m3 , 6 
m3, 13 
m3, 
m3, 
m3 , 6 
m3 , 13 


Show(xyz); 
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About the entry point that you 
pointed out in the Pool Puzzle—does this 
mean I can have a program that doesn’t 
have a Forml form? 

A! Yes. When you create a new Windows 
Application project, the IDE creates all 
the files for that project for you, including 
Program.es (which contains a static class 
with an entry point) and Forml.cs (which 
contains an empty form called Forml). 

Try this: instead of creating a new Windows 
Application project, create an empty project 
by selecting Empty Project instead of 
Windows Application when you create a 
new project in the IDE. Then add a class 
file to it in the Solution Explorer and type in 
everything in the Pool Puzzle solution. Since 
your program uses a message box, you 
need to add a reference by right-clicking 
on References in the Solution Explorer, 
selecting Add Reference, and choosing 
System.Windows.Forms. (That’s another 
thing the IDE does for you automatically 
when you create a Windows Application.) 
Finally, select Properties from the Project 
menu and choose the Windows Application 
output type. 

Now run it … you’ll see the results! 
Congratulations, you just created a C# 
program from scratch. 

plif batk bo 2 - i-f you 

a v-c-fv-csVicv- oy\ Ma0 

ar\d po’m 七 f 


You can show the Class View page 
using the View menu, and it’s yet 
another tool the IDE gives you to 
help you explore C#. It’s usually 
docked in the Solution Explorer 
window, and it lets you explore the 
classes in your solution — which 
can come in very handy. 



Can I inherit from the class that 
contains the entry point? 

A! Yes. The entry point must be a static 
method, but that method doesn } t have 
to be in a static class. (Remember, the 
static keyword means that the class 
can’t be instantiated, but that its methods 
are available as soon as the program starts. 
So in the Pool Puzzle program, you can 
call TestBoats . Main () from any 
other method without declaring a reference 
variable or instantiating an object using a 
new statement.) 

I still don’t get why they’re called 
"virtual” methods—they seem real to me! 

The name “virtual” has to do with how 
.NET handles the virtual methods behind the 
scenes. It uses something called a virtual 
method table (or vtable). That’s a table that 
■NET uses to keep track of which methods 
are inherited and which ones have been 
overridden. Don’t worry—you don’t need to 
know how it works to use virtual methods! 



is o o - 


<Search> T 

J SandwichAnalyzer 

> 麵 Project References 
J {} Sandwich Analyzer 
J % BLT 

Base Types 


Sandwich 


t> *t： F&rml 
t> Program 

Sandwich 、 

© CountCabriesQ Clidk a dldss m 
声 SlicesGfBread ^ Class View b> 

^ Toasted its m ⑽ bas. 

Solution Exp lorer Cl ass View 
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What did you mean by only being 
able to move up the class diagram but 
not being able to move down? 

A! When you’ve got a diagram with one 
class that’s above another one, the class 
that’s higher up is more abstract than the 
one that’s lower down. More specific or 
concrete classes (like Shirt or Car) 
inherit from more abstract ones (like 
Clothing or Vehicle). When you 
think about it that way, it’s easy to see how 
if all you need is a vehicle, a car or van or 
motorcycle will do. But if you need a car, a 
motorcycle won’t be useful to you. 

Inheritance works exactly the same way. If 
you have a method with Vehicle as a 
parameter, and if the Motorcycle class 
inherits from the Vehicle class, then you 
can pass an instance of Motorcycle 
to the method. But if the method takes 
Motorcycle as a parameter, you can’t 
pass any Vehicle object, because it may 
be a Van instance. Then C# wouldn’t know 
what to do when the method tries to access 
the Handlebars property! 

You can always 
pass an instance 
oi a subclass to 
any metkod wkose 
parameters expect a 
class tkat it extends. 

、 Use i\\t Base Types 

-foldcv - m CUss \/»c>m 
■to a ^lass^s 
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you really do need them 


o O 


tbls! 



工 JUST DOM，T S5B WHY 工 NBBD TO 
USB TH^SB 'VlRTUAU x, AND ' v ^VBRRIDB ,/ KEYWORDS- IF I 
DOM，T USB THBM ； THB 工 JUST &WBS MB A WARM IM^, BUT THB 
WARMING D^BSM^ ACTUALLY MBAM ANrTHIM^^.MY PR^RAM 
STIUU RUNS ! 工 MBAM, 工 , UU PUT THB ICBYW^RDS IM IF IT，S THB 
' V RI^NT ,/ THIM 公 TO DO, BUT IT JUST SBBMS UK6 JUMPING 
THROUGH ViOOPS f=^R NO &OOX> RBAS^N. 


There’s an important reason for virtual and override! 

The virtual and override keywords aren’t just for decoration. They 
actually make a real difference in how your program works. But don’t take our 
word for it — here’s a real example to show you how they work. 

I^s-tcad tv-catmj a l/V'mdov/s Fov-ms 
youVc jo'mj *to a 

於 w CoY\So\t ms*tcad! Tins 

me 扣 S rt Wt Viavc a 


❶ 



DEBATE A NSW CObiSOUB APPU^ATI^M AMD ADD CLASSES. 

Right-click on the project in the Solution Explorer and add classes, just like normal. Add the 
following five classes: Jewels, Safe, Owner, Locksmith, and JewelThief. 


❺ 


Noii 乙 e how 
the p\rivatc 
keywovd 
hides the 
^Oh-tchts ahd 

匕 ombihd'tioh. 


ADD THB C^t>B F^E THB NEW 6UASSBS. 

Here’s the code for the five new classes you added: 

class Jewels { 

public string Sparkle() { 

return "Sparkle, sparkle !’，； 

} 1 A obi^t keeps a Jewels 

七。七 Uhlcss OpchO is died 

with the irigh-t dombihd-tioh. I 

class Safe { J 

private Jewels contents = new Jewels(); 
private string safeCombination = "12345"; 
public Jewels Open(string combination) 


if (combination == safeCombination) 
return contents; 

else 

return null; 

} 

public void PickLock(Locksmith lockpicker) { 

lockpicker.WriteDownCombination(safeCombination); 


Console appli^a-tiohs 

dor) J i use (o^s 

t dohsolc w •…如 d 

V ，h r dows Fo ^ s a\\ ihe m 

U you is a hC w caWcd fVo ㈣ 

^ ah 叫切 c^y poi.i .eihod. 

you v-u, ii ii pops up , Co ^ d wjhdow 

to display thea I 。七 o*f 

^achcc usih 9 dohsolc applidatiohs ovcv- the 
hex 七 -rew dhap*tcvs. 
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A lodksmi 七 h Car\ fidk *thc domb'ma*tio^ 
lodk ar>d *tKc domb'ma*tior> by dall'm^ 
•the PidkLodkO method BY\d fass'm^ *m a 
V*C-(*CV*C^dC *to himscl-f. The sa-rc dal Is his 
^/v*i*tcPov/^Cornbm3*tio^() method w.rth 
domb'matio^. 








class Owner { 

private Jewels returnedContents; 

public void ReceiveContents(Jewels safeContents) { 

returnedContents = safeContents; 

Console.WriteLine("Thank you for returning my jewels! 


inheritance 


safeContents•Sparkle()); 


O THE JEWBUTHIBF 6UASS IMHBEITS FEOM U^KSMITH- 

Jewel thieves are locksmiths gone bad! They can pick the lock on the safe, but 
instead of returning the jewels to the owner, they steal them! 

class Locksmith { 

public void OpenSafe(Safe safe. Owner owner) { 
safe.PickLock(this); 

Jewels safeContents = safe.Open(writtenDownCombination); 
ReturnContents(safeContents, owner); A Lodksmi-t^s method 

} 々 pi£.ks ihc lotk, oytv\s the sa-Pe ； a^d 

v*ctuv*^s -the -fco -the ovmev*. 


Locksmith 


OpenSafef) 

WriteDownCombinationf) 

ReturnContents() 


i 


private string writtenDownCombination = null; 
public void WriteDownCombination(string combination) 
writtenDownCombination = combination; 

} 


public void ReturnContents(Jewels safeContents 
owner.ReceiveContents(safeContents); 


Owner owner) 


JewelThief 


ReturnContents() 


class JewelThief : Locksmith { 

private Jewels stolenJewels = null; 

public void ReturnContents(Jewels safeContents, Owner owner) 
stolenJewels = safeContents; 

Console•WriteLine( n 工 'm stealing the contents!' 


o 


THB MainO METHOD THE PROGRAM- 

But don } t run it just yet! Before you run the program, try to figure out 
what it’s going to print to the console. 


+ stolenJewels•Sparkle()); 

A JcwcIThic-P object 'mhevits *thc 

By\A lVv-i*tcPoy/r>Combma*tioir\() 

1 ^ ^ 

methods. Bu 七 ^i\\tY\ the 
method dalls Rc*tu\nr>Co^*tc^tsO *to v-c*tuv-^ 
■the jewels *to the the Jcv/cIThic-P 

s*tcaU 七 hem ms*tcad| 



class Program { 

static void Main(string[] args) 
Owner owner = new Owner(); 
Safe safe = new Safe(); 


id^cyO 


Rea 
waits loir 七 he 
useir -fco press 

a key. li keeps 
七 he piroyam 

■fv-orw 


JewelThief j ewelThief = new JewelThief(); 
jewelThief.OpenSafe(safe, owner); 

Console.ReadKey(); 


c^^rpen your pencil 


Read through the code for your program. 
Before you run it, write down what you think it 
will print to the console. (Hint: figure out what 

JewelThief inherits from Locksmith!) 
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hide and seek 


A subclass can hide methods m the superclass 


Go ahead and run the JewelThief program. Since it’s a console application, instead 
of writing its console output to the Output window, it’ll pop up a command window 
and print the output there. Here’s what you should see: 


file:/y/C:/Users/;Pyblic/Documents/Visual Studio 2012." 


hank you for returning my jewels? Sparkle, sparkle 


Did you expect the program’s output to be different? Maybe something like this: 
I'm stealing the contents! Sparkle, sparkle! 


It looks like the JewelThief acted just like a Locksmith! So what happened? 


Hiding methods versus overriding methods 

The reason the JewelThief object acted like a Locksmith object when its 
ReturnContents () method was called was because of the way the JewelThief class 
declared its ReturnContents () method. There’s a big hint in that warning message 
you got when you compiled your program: 


Error List 



▼ 0 Errors 

Description 


! 1 Warning 


Search Error List 


fi- 


File 


1 J eweirrihief JeweFThief.MeturnContents(JeweFIhief JewelJewelThief.Owner } 1 hides inherited member Jewenhief.es 
1 Jewellhiief.Locksmih.MeturnContents(iewelThi ; ef Jewels, JewefiThief.Owner) 1 ™ To make the current 
member override that implementation, add the override keyword. Otherwise add the new keyword. 


Since the JewelThief class inherits from Locksmith and replaces 
the ReturnContents () method with its own method, it looks 
like JewelThief is overriding Locksmith’s ReturnContents () 
method. But that’s not actually what’s happening. You probably 
expected JewelThief to override the method (which we’ll talk about 
in a minute), but instead JewelThief is hiding it. 

There’s a big difference. When a subclass hides the method, it replaces 
(technically, it redeclares) a method in its base class that has the same 
name. So now our subclass really has two different methods that share 
a name: one that it inherits from its base class, and another brand-new 
one that’s defined in its own class. 


II a sutetass just adds a 
metkoct witk tke same 
name as a metkoct in its 
superclass, it only kides 
tke superclass itietkod 
insteact oi overriding it. 
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inheritance 


Use different references to call hidden methods 

The JewelThief only hides the ReturnContents () method (as opposed to overriding it), and that causes 
it to act like a Locksmith object whenever it’s called like a Locksmith object. JewelThief inherits one 
version of ReturnContents () from Locksmith, and it defines a second version of it, which means that 
there are two different methods with the same name. That means your class needs two different ways to call it. 

And, in fact, it has exactly that. If you’ve got an instance of JewelThief, you can use a JewelThief 
reference variable to call the new ReturnContents () method. But if you use a Locksmith reference 
variable to call it, it’ll call the hidden Locksmith ReturnContents () method. 


// The JewelThief subclass hides a method in the Locksmith base class, 

// so you can get different behavior from the same object based on the 
// reference you use to call it! 

// Declaring your JewelThief object as a Locksmith reference causes it to 
// call the base class ReturnContents() method 
Locksmith calledAsLocksmith = new JewelThief(); 
calledAsLocksmith.ReturnContents(safeContents , owner); 

// Declaring your JewelThief object as a JewelThief reference causes it to 
// call the JewelThief's ReturnContents() method instead, because it hides 
// the base class's method of the same name. 

JewelThief calledAsJewelThief = new JewelThief(); 
calledAsJewelThief.ReturnContents(safeContents, owner); 


Use the new keyword when youVe hiding methods 

Take a close look at that warning message. Sure, we never really read most of our warnings, right? But this 
time, actually read what it says: To make the current member override that implementation, add 
the override keyword. Otherwise add the new keyword. 

So go back to your program and add the new keyword. 

new public void ReturnContents(Jewels safeContents, Owner owner) { 

As soon as you add new to your JewelThief class’s ReturnContents () method declaration, that 
warning message will go away. But your program still won’t act the way you expect it to! It still calls the 
ReturnContents () method defined in the Locksmith object. Why? Because the ReturnContents () 
method is being called from a method defined by the Locksmith class — specifically, from inside 
Locksmith . OpenSafe (), even though it’s being initiated by a JewelThief object. If JewelThief 
only hides the ReturnContents () method, its own ReturnContents () will never be called. 

Can you figure out how to get JewelThief to override the ReturnContents () method 
instead of just hiding it? See if you can do it before turning to the next page! 
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and that’s why you need those keywords 

Use the override and virtual keywords to mhcrit behavior 

一 、 

We really want our JewelThief class to always use its own ReturnContents () 
method, no matter how it’s called. This is the way we expect inheritance to work most 
of the time, and it’s called overriding. And it’s very easy to get your class to do it. 

The first thing you need to do is use the override keyword when you declare the 
ReturnContents () method, like this: 

class JewelThief { 

• •馨 

override public void ReturnContents 

(Jewels safeContents r Owner owner) 


But that’s not everything you need to do. If you just add that override and try to 
compile, you’ll get an error that looks like this: 


Error List 



© 1 Error 


! 0Warning! 


0 Messages 


Search Error List 


P- 


Description 


▲ 


File 


'ieweflhiefJeweHhief.ReturnConlentsCJewenrhtef Jewels, JewefThief.Owner} 1 : cannot override inheried JewenFhief.es 
member 1 JewelThrefXocksmih.MetumContents(JeweirThief Jewels, Jewerfhiel.Ownei} 1 because i is not 
marked virtual, abstract, or override 


Again, take a really close look and actually read the error. JewelThief can’t override the 
inherited member ReturnContents () because it’s not marked virtual, abstract, 
or override in Locksmith. Well, that’s an easy error to fix! Just mark Locksmith’s 
ReturnContents () with the virtual keyword: 

class Locksmith { 


virtual public void ReturnContents 

(Jewels safeContents , Owner owner) 

Now run your program again. Here’s what you should see: 



fi I e : /7/C :/U se rs/Py b I i q/Docu me nts/Visu a I Studio 2012... 


stealing the contents? Sparkle, sparkle 


n 




a 


And that’s the output we were looking for. 
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VOHBM I CO/^B UP WITH MY 
6UASS HIBEAR^HY, I USUALLY 
WAMT JO ^VBRRIDB METHODS 
AMD N^T HIDE THEM. BUT IF 工 DO 
HIDE THEM, 工 , UU ALWAYS USB 
THE NB\aJ KBYW^ED, ElfirHT? 


Exactly. Most of the time you want to 
override methods, but hiding them is 
an option. 

When you’re working with a subclass that extends 
a base class, you’re much more likely to use 
overriding than you are to use hiding. So when you 
see that compiler warning about hiding a method, 
pay attention to it! Make sure you really want 
to hide the method, and didn’t just forget to use 
the virtual and override keywords. If you 
always use the virtual, override, and new 
keywords correctly, you’ll never run into a problem 
like this again! 


II you want to 
override a metkoct in 


a Use class, always 
mark it witk tke 
virtual keyword, 
and always use tke 
override keyword 
any time you want 
to overricte tke 
metlroct in a subclass. 
II you cton’t ， you’ll 
end up accictentally 
kictingf metkocts 
insteact. 
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detour: construction ahead 


A subclass caw access its base class using the base keyword 


Even when you override a method or property in your base class, 
sometimes you’ll still want to access it. Luckily, we can use base, which 
lets us access any method in the base class. 



All animals eat, so the Vertebrate class has an Eat () method that 
takes a Food object as its parameter. 

class Vertebrate { 



Digest(); 


public virtual void Eat(Food morsel) { 

Swallow(morsel); 


Vertebrate 

NumberOfLegs 


Eat() 

Swallow() 

Digest() 


Chameleon 

TongueLength 

Color 


Catch WithTongueQ 


❺ 


Chameleons eat by catching food with their tongues. So the Chameleon class inherits 
from Vertebrate but overrides Eat (). 


class Chameleon : Vertebrate { 

public override void Eat(Food morsel) { 

CatchWithTongue(morsel); 

Swallow (morsel) heeds io swallow 5hd 

Digest(); J the lood, jusi like a,y oi^ 釙晌 I. g 

} 代 ally heed 铋 duplicate this to&t, though? 



Instead of duplicating the code, we can use the base keyword to call the method that 
was overridden. Now we have access to both the old and the new version of Eat (). 

class Chameleon : Vertebrate { 

public override void Eat(Food morsel) { , , . 

CatchWithTongue (morsel) ; TW»s I'mC tails i\\t ta*tO method ^ 
base .Eat (morsel) __ t | ass 七 wt Chameleon mV\cvacd 

} 

Now that you’ve had a chance to absorb some of the ideas behind inheritance, here’s something to think 
about. While reusing code is a good way to save keystrokes, another valuable part of inheritance is that it 
makes it easier to maintain your code later. Can you think of a reason why that’s true? 
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inheritance 


Whew a base class has a constructor, your subclass needs owe, too 


If your class has constructors that take parameters, then any class that 
inherits from it must call one of those constructors. The subclass’s 
constructor can have different parameters from the base class constructor. 

class Subclass : BaseClass { 

— ^public Subclass (parameter list) 


yJ ： lih l ^ ^ 

io idi c* 刨破 

心拉 is ih 似咖 .、 y ^ 


ttcirc s -the 
^Ohs-tvu^-tov- -Pov 
"the sub^ldss. 


base(the base class^ s parameter list) { 



II first the base class constructor is executed 
// then any statements here get executed 


The base class constructor is executed 
before the subclass constructor 

But don’t take our word for it — see for yourself! 




Create a base class with a constructor that pops up a message box. 


You can call the new statement 
without assigning the result to a 
variable. The following statement 
creates an instance of MySubclass: 
new My Subclass (); 

It will be garbage-collected quickly 
because there’s no reference to it. 


Then add a button to a form that instantiates this base class and shows a message box: 


class MyBaseClass { 

public MyBaseClass(string baseClassNeedsThis) { 


MessageBox.Show("This is the base class : " + baseClassNeedsThis); 

This is a ihai -the 

base dass dohs-tv-ud-fcov- heeds. 




Try adding a subclass, but don’t call the constructor. 

Then add a button to a form that instantiates this subclass and shows a message box: 


^-^class MySubclass : MyBaseClass{ 

Scled ： Build->Build public MySubclass(string baseClassNeedsThis, int anotherValue) { 
Solu-tioh ih "the II)B MessageBox. Show ( "This is the subclass : " + baseClassNeedsThis 


you'll get ah 
emrom -P\ro^ -this 
乙 ode. } 


and " + anotherValue); 



3r\ eye out -fov 
this c\r\rov. H medhS 
"that you\r subdl^ss 
didr /七 dall the base 




Fix the error by making the constructor call the one from the base class. 

Then instantiate the subclass and see what order the two message boxes pop up in! 


class MySubclass : MyBaseClass{ 

This is how public MySubclass (string baseClassNeedsThis 

wc sehd the 一 ^ : base (baseClassNeedsThis) 一 - - — —^ 

base dass the { 

pavawtev* i*ts // the rest of the subclass is the same 

toY\S>{x\At{p>r 

heeds. 


,int anotherValue) . , .1 

Add Irne -to Wl C# 6aII 

工，心融 

see W message Wes W 外 . 
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kathleen still needs our help 


Now youVe ready to finish the job for Kathleen! 


When you last left Kathleen, you’d finished adding birthday parties to 
her program. She needs you to charge an extra $100 for parties 
over 12. It seemed like you were going to have to write the same 
exact code twice, once for each class. Now that you know how to use 
inheritance, you can have them inherit from the same base class that 
contains all of their shared code, so you only have to write it once. 


If we play our cards 
right, we should be 
able to change the two 
classes without making 
any changes to the form! 



Finish the job for Kathleen by creating a Party base class that has all 

of the shared behavior from Dinnerparty and BirthdayParty. oc 3 七 /0 ^ ssc 

side by side. I/Vhai 
methods and pv*opc\rtics 
do m dorwrwor\? 



THINK. AB^UT THE NBW 6UASS 
MODE “ 

The first step to writing a good program 
is thinking about its design. We’ll 

still have the same DinnerParty and 
BirthdayParty classes, but now 
they’ll inherit from a single Party 
class. We need them to have exactly 
the same properties so we don’t have to 
make any changes to the form. 


DinnerParty 


BirthdayParty 

NumberOfPeople: int > 

n 

卜 NumberOfPeople: int 

FancyDecorations: bool ^ - 

: 

►FancyDecorations: bool 

Cost: decimal < 

卜 Cost: decimal 

HealthyOption: bool 

private methods: 


CakeWriting: string 
CakeWritingTooLong: bool 
private ActualLength: int 

— 

CalculateCostOfDecorations()^. 


orivate methods: 

CalculateCostOfBeverages 


^ CalculateCostOfDecorations() 

PerPersonf); 


CakeSize() 

MaxWritingLengthf) 



ADD THE PAETY BASE CUASS. 

Create a new Windows Forms application. 

Add a class called Party to the program. 

Then add the DinnerParty and 
BirthdayParty classes from the project at 
the beginning of this chapter, and update the 
DinnerParty and BirthdayParty classes 
so they extend Party. 



The -first tliihg you’ll 
/ do is sdd crwpty 

匕 lass, Ad 

^odi-ry Dihhcv-Pavty 
BiirthdayPav-ty 
so they cx-tchd it 

^l\rody build 
you\r ^oyra^, bemuse 
ahy-th'mg extehd 

如 empty c.\ass. 
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inheritance 


o 


o 


M^VB SHARED BEHAVIOR \biTO THE PARTY SUPBE^UASS. 

Gut the CostOf FoodPerPerson constant, the NumberOf People and FancyDecorations 
properties, and the CalculateCostOf Decorations () method from either the DinnerParty or 
BirthdayParty class (they’re identical in both), then paste them into Party. Make sure you delete 
them from both subclasses. 

Create a Cost property in Party and mark it virtual, and mark the Cost in the subclasses 
override. 


doi\\ classes use i\\t 
pa^tyPcdov-a-tions fv-ofcv-tics 

•m same way. 1 七 

makes scr\sc to 

-fv-om i\\t Party supcv-tlass. 


Party 


NumberOfPeople: int 
FancyDecorations: bool 
virtual Cost: decimal 备 — 


Even -though bo 七 h classes hdve 
d\((c^Y\i ways o( 

七 he dos-t, 七 hey boih USC "the SdnrtC 
C^l ^uld'bc Cos*tO-f Dc^o\r3iior)s() 
rtneihod- Bui ii^s p\rivaic, so ihc 
subclasses access iil 


private methods: 
CalculateCostOfDecorations() 


He\re’s ihc extended Cost 
p\ropc\rty. li's declared wi-th 
七 he override keyv/ovd, and will 

匕 all base-Cost 



Luckily, v/c cav\ -take adva 山 ge o*f 
i^hcvi-ta^c. IVcII dedave Cos-t as 
vi\rtual *m 七 he supe\rdass, and ih ⑶ 
extend i*t \y\ *thc sub^ldsses. 


DinnerParty 


BirthdayParty 

HealthyOption: bool 


CakeWriting: string 

i override Cost: decimal 


CakeWritingTooLong: bool 
override Cost: decimal 
private ActualLength: int 

private methods: 


private methods: 

CalculateCostOfBeverages 


CakeSizef) 

PerPersonf); 


MaxWritingLength() 


The hardest part of this exercise is figuring out what part of the two Cost properties in the subclasses 
should be copied to the Party base class. That’s because you have a lot of choices. You could just create 
an automatic Cost property in the Party class, and keep the Cost property in the subclasses the 
same. But for this exercise, your job is to look at the Cost properties in the original DinnerParty and 
BirthdayParty classes, figure out what they have in common, and move as many lines as you can into 
the base class. 

Here’s a hint. Both DinnerParty and BirthdayParty Cost properties should start with these lines: 

override public decimal Cost { 
get { 

decimal totalCost = base.Cost; 

Don’t forget to add the $100 charge for parties over 12 to the base Cost property in Party. 
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exercise solution 



Check it out—you changed the Dinnerparty and BirthdayParty classes so that 
they inherited from the same base class, Party. Then you were able to make the change to 
the cost calculation to add the $100 fee, and you didn’t have to change the form at all. Neat! 


class Party 


public const int CostOfFoodPerPerson = 25 


public int NumberOfPeople { get; set; 


public bool FancyDecorations { get; set, 


v. TV^csc pvopcv-tics 七 he doy\s*t3r\*t 

— y/eve m Pm^cvPav-ty 

Biv^dayParty, so v/eve ui 
^ subtl3sscs dy>ci 


m*to 七 he supcV"C.l 3 ss. 


private decimal CalculateCostOfDecorations() 



decimal costOfDecorations; 
if (FancyDecorations) 

costOfDecorations = (NumberOfPeople * 15.00M) + 50M, 

else 

costOfDecorations = (NumberOfPeople * 7.50M) + 30M; 
return costOfDecorations; 


Pern ’ 七 

"to 

mdrk Cost 
virtual! 


This rwethod y/ds also 
idertiidal \v\ boih 
subclasses, so ii was 
rwoved to 七 he Pav-ty 
base dlass -too. 


virtual public decimal Cost 

" 

get { 

decimal totalCost = CalculateCostOfDecorations(); 
totalCost += CostOfFoodPerPerson * NumberOfPeople; 


if (NumberOfPeople > 12) 
totalCost += 100; 




return totalCost 


-b^at *tV)C biv-t^day dirmer 
partes V^ave -tViciv- ov/y\ classes *(^a 七 
} tVic Party base tlass, .Vs easy -to 

} add ^ jlOO eMdry -for parties over 

IZ. Just add \i fe) tVic base tlass, a^d 
i\,t subclasses will mVicrit b^av.o^r. 

class BirthdayParty : —Party gi^daypa^y dds Pa\rty. 

public BirthdayParty(int numberOfPeople, 

bool fancyDecorations, string cakeWriting) 


These *two I’mes wcv-c ide^*ti^dl 
bo-tii oiri^'mdl D*m^cv-Pa\rty 
Biv-thdayPav-ty classes, so y/c 
moved *to -the base Cos*t 
p\ropcv-*ty. Wlc moved as wwacM 
bchaviov as wc 乙 ould m*bo 
Pav-ty ^lass. 


NumberOfPeople = numberOfPeople; 
FancyDecorations = fancyDecorations; 
CakeWriting = cakeWriting; 


TV^c Bir^daYParty tcmsWW 
stays same, even *rt sets 

pvofev-tics i\\ai av-c *m i\\c base tlass. 


\v\ 
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public string CakeWriting { get; set; } 

private int ActualLength 

{ 

get 

{ 

if (CakeWriting.Length > MaxWritingLength() 
return MaxWritingLength(); 

else 

return CakeWriting.Length; 


Cakcl/Vvitmj av-c o^ly 

used by Bi\rthdayPav-ty but v\oi Paviy, 
s <> they stay Biv-thdayPav-ty. 


private int CakeSize() { 

if (NumberOfPeople <= 4) 
return 8; 

else 

return 16; 


private int MaxWritingLength() 
if (CakeSize() == 8) 
return 16; 

else 

return 40; 



e 



public bool CakeWritingTooLong { 
get { 

if (CakeWriting.Length > MaxWritingLength() 
return true; 

else 

return false; 


TKc CakeiAM 七 ” 
pv-opcv"*ty) 

A 乙 tualL ⑼咖 

pv-ofev-tyj a 灼 d 七 he 
methods 
use stay m 
B*iv-t^daYPa\rty 
tlass. So docs 

pv-ofev-ty. 


override public decimal Cost { 
get { 

decimal totalCost = base.Cost; 
decimal cakeCost; 
if (CakeSize() == 8) 


VVe moved -f iv-s-t b^o s*ta*tcr^cr\*ts of 

Cos 七 pvopcv"*ty m*to *bKc base tlass bcdausc 
{\\Oj y/eve idcr\*ti^3l both Pmr\CV~Pav-"ty 
ar>d Biv-tKaayPavty. Ti^c (\rsi 祝吒 
Bivt^dayPavtys Cos 七 pvopcvty dots is dal I 
basc Cos-t bo c%ctu*tc {host b^o 


cakeCost = 40M + ActualLength * .25M; 

else 

cakeCost = 75M + ActualLength * .25M; 
return totalCost + cakeCost; 
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great job! 



如 las 七 dass m 祕 lea’s solution. 
TV^cvc's y\o 乩 ar^e *to 七 he -form Code a*t all. 

RClSO class DinnerParty : Party { 

%OLpi\OH 

CpHtlHv^P 
你 PH W?7 



public bool HealthyOption { get; set; 


The ttcalthyOptio^ pv-opc\rty is oir)|y 
used m di^meir pairtics, no 七 birthday 
parties, so it stays ih the dass. 


public DinnerParty(int numberOfPeople, bool healthyOption f 

bool fancyDecorations) { 

NumberOfPeople = numberOfPeople; 

FancyDecorations = fancyDecorations; 

HealthyOption = healthyOption; 


private decimal CalculateCostOfBeveragesPerPerson() 


decimal costOfBeveragesPerPerson; 
if (HealthyOption) 

costOfBeveragesPerPerson = 5.00M; 

else 

costOfBeveragesPerPerson = 2 0.00M; 
return costOfBeveragesPerPerson; 


Tk CaldaW 七祕 
me 七 W and 払 c siay m tht 

tlass because 七 W 代⑽七 

used by 


override public decimal Cost { 
get { 

decimal totalCost = base.Cost; 

totalCost += CalculateCostOfBeveragesPerPerson() 
if (HealthyOption) 

totalCost *= .95M; 
return totalCost; 




* NumberOfPeople 

k Tiic Cos 七 fvofcvty v/ovks jus 七 like m 
^ i\)t Biv-tlidaYPav-ty dass. \i uses base. 

Cos 七 *bo 七 he S*ta*tcmCir>*U m 

Pav-*ty Cos*t, av>d uses {Mt vesiAl*t as a 
s*tav*t*m^ fom*t *to -f misii taltula*tiov>. 


TH5 PR^RAM^ PBRFB6T. IT^ SO MU6H 
BASIBR TO RUN MY BUSIMBSS N^W-THAMICS SO MU6H 



When your classes overlap as little as possible, that’s an important design 
principle called separation of concerns. 

When you design your classes well today, they’ll be easier to modify later. It would have been a lot of work to 
add that SI00 charge for parties over 12 to the separate DinnerParty and BirthdayParty classes. But 
after you redesigned your program with inheritance, it just took two lines of code. This was easy because you 
moved only the behavior that was shared between the Cost properties in the subclasses into a shared property in the base class. 

This is an example of separation of concerns, because each class has only the code that concerns one 
specific part of the problem that your program solves. Code for dinner parties goes in DinnerParty, code 
for birthday parties goes in BirthdayParty, and code that’s shared between them goes in Party. 

Here’s something to think about. We separated the concerns about the user interface into the Form object. It 
doesn’t do cost calculations itself — that’s encapsulated behind the Cost properties of the DinnerParty and 
BirthdayParty classes. But we decided that converting the decimal cost to a current string is a concern of 
the Form, not something that the party classes need to be concerned with. Did we make the right call? 
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Remember dr>y pv-oyam Uv\ be y/vrttc 的 m 

v/ays, and usually 七 here’s 的。 si—c Vi 吵七 , 
ar>sy/cv. Moi cvcr> i-f its y/vrbt 伙 m a book! 















Puild a beehive management system 

A queen bee needs your help! Her hive is out of control, and 
she needs a program to help manage it. She’s got a beehive full 
of workers, and a whole bunch of jobs that need to be done 
around the hive. But somehow she’s lost control of which bee 
is doing what, and whether or not she’s got the beepower to do 
the jobs that need to be done. 

It’s up to you to build a beehive management system to help 
her keep track of her workers. Here’s how it’ll work: 

❶ THE ©UBBM ASSIGNS J^BS 
TO HBR 

There are six possible jobs that the workers can do. Some 
know how to collect nectar and manufacture honey; others 
can maintain the hive and patrol for enemies. A few bees can 
do every job in the hive. So your program will need to give 
her a way to assign a job to any bee that’s available to do it. 



inheritance 




口 J 


Beehive Managemen 


Worker Bee Assignments 
Job 

Honey manufacturing 

Baby bee tutoring 
Egg care 

Hive maintenance 


Nectar collector 






Beehive Man 


Worker Bee Assignments 


Job 


Honey manufacturing 


—L 


Assign this job to a bee 



The bees y/o\rk shi-f-U ； 
dhd nr»os*t jobs v*c^ui\rc 
tisoYt OhC shi-ft 

So the 

the o-P shi-p*ts 

the job y/ill take, 
didks 七 he u Assijh 

"this job” button. 



TiVis dv*o^—dov/r^ lis*t shows dll s.i% jobs 七 ha 七七 he 
v/ovkevs doThc kr>o>MS v/ha*t jobs Y\ttd 

*to be &oy\t) sKc docs^ V"C3lly \wiVidii bcc 
docs tdiCM job- So sKc jus*t sclcd*U v/hidh job *to 
be dor>C—-the v/ill -fi^uvc ou*t if 七 KevVs a 

y/ovkcv available io do \i, ar\d ass'i^ 七 he job *to 


I-P theire’s a bee 

available "to do -the job ； 
"the pv-ojvarw assies 
七 he job -to ihc bee Bv\d 

lets the k 灼 

it’s takers C^rt o-p. 


The queen bee says... 


Thejob Honey manufacturing 1 will be done in 3 shifts 


OK 


@ VOHBM THE JOBS AEB AUU ASSIGNED, IT X S 
TIME TO VJO^K. 

Once the queen’s done assigning the work, she’ll tell the bees 
to work the next shift by clicking the “Work the next shift” 
button. The program then generates a shift report that tells 
her which bees worked that shift, what jobs they did, and 
how many more shifts they’ll be working each job. 

Report for shift #1 

Worker #1 is doing 'Honey manufacturing ' for 2 mors shifts 


System 





Work the next 
shift . 


you are here ► 


279 

























































































mind your beeswax 


How you’ll build the beehive mawagemewt system 

This project is divided into two parts. The first part is a bit of a review，where you’ll create the basic 
system to manage the hive. It’s got two classes, Queen and Worker. You’ll build the form for the system, 
and hook it up to the two classes. And you’ll make sure the classes are well-encapsulated so they 
don’t get in your way when you move on to the second part later. 


This is the object model that you’ll 
build. The form has a reference to an 
instance of Queen, who keeps track 
of her Worker objects using an array 
of Worker references. 


Tk -Po\r^ keeps a v-c-fcv-chdc 
■to "the objedt ih a 
-field called 



No 七 cvev-y wo\rkcv- do cvcv-y 
job. Eadh l/Vo\rkcv- objed-t has By\ 
a\r\ray o( siv'mjs dal led jobsICa^Do 
ihai it uses -to keep ivadk o-f 
whi 匕 h jobs rt kr>ov/s how "to do. 


[0] Nectar collector 
[1] Honey manufacturing 


0] Egg care 
[1] Baby bee tutoring 



The has a -field 

called >wo\rkcv-s -to keep 
■tvadk o( all *thc IVbvkcir 
objedts *m the hive- 


This y/ovkcv cav\ do *tv/o jobs, c% 
ddve d^d baby bcc so \\\s 

jobsICa^Po avv-ay V^as *Uo elemeyrts. 


[0] Hive maintenance 
[1] Sting patrol 


This is a 


vcirsaiilc 

do s'nc 


She keeps -the y/o\rkc\rs avvay pviva-tc 
because y\o o-thev- objects should be 
able "to *tdl v/oirkcv-s y/ha-t "to do, so 
she needs "to set up the y/o\rkcv-s m 
hcv- do^s-tv-udiov-. 


vcv-y \ 

.f ~ v/o\rkc\r. He C3v\ 
y di*P*Pevwt jobs/ 

[0] Nectar collector 

[1] Honey manufacturing 

[2] Egg care 

[3] Baby bee tutoring 

[4] Hive maintenance 

[5] Sting patrol 
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The form creates the array of workers. Then it 
creates each worker and adds it to the array. 


Wbrkcv object’s takes 


OY\t 


Worker[] workers = new Worker[4]; 
workers[0] = new Worker(new string[] 

new Worker(new string[] 
new Worker(new string[] 
new Worker(new string[] 
,"Baby bee tutoring ", 


workers[1]= 
workers[2]= 
workers[3 ]= 
"Egg care 
queen = 


faramcW, ^ a^ay tell ’it 

y/V^at jobs *rt ky^ows \\o^ *to do. 

'Nectar collector ", "Honey manufacturing* 
'Egg care", "Baby bee tutoring" }); 

'Hive maintenance ", "Sting patrol" }); 
'Nectar collector ", "Honey manufacturing* 


}) 


Hive maintenance 


Sting patrol" }) 


new Queen(workers) 


The has a -field 七 ha 七 points -to a 没 “ ⑽ object, whidh i-t miiializ^s by 

passing ihc 於 wly Sealed a^\ray o( iVovkcv objects m-to ihc ^ucc^s co^s\y 


The queen checks 
each worker to see 
if he’s available to 
do the job. 


The /\ssi^Wo\rkO method Joes 

-thv-ou^h the av-v-ay o( wov-kev-s, dallmj 
tBt\\ OY\ts PoThisJobO method u^til 

she -f mds or\t v/ho do *thc job. 



do^siv-udW- I/Vhch the W assigh ；； buttoh is 

d\tkcd, the ^ucch^s ^ssi^hlVov^k 
method is Ulied so she Uh 

dhc^k i-p wo\rkc\rs a\rc available. 

AssignWork ( "Hive maintenannp，’. 4) 




The form calls the queen’s 
AssignWork () method, which 
loops through the workers and calls 

each one’s DoThis Job () method 

until it finds a worker who can do 
the job. If no workers can do the job, 

AssignWork () returns false. 





The queen can 
assign work to 
workers and then 
tell them to work 
the next shift. 


_ 丁 k is askih^ a l/Vov-ke^ 

广 if he Ur\ do Hive Maih-tch^hdc 
^ shifts. 

nnThisJob( M Hive maintenance' 4) 





If the worker is already doing a job, he returns 
false. Otherwise, he checks his j obsICanDo 
array. If he finds the job, he returns true; 
otherwise, he returns false. ’ 



The queen tells each worker to work a shift, then 
compiles the results into a shift report. 


rkTheNextShift () 



The Workers DidVouFihishO method 

r^akes Wvnx wo\rk the hext shi-fi, and 
v*ctu\rhs i-P he -f mishes -the job. 

PidYouFinish() 






you are here ► 
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A queen bee needs your help! Use what you’ve learned about classes and objects to build a 
beehive management system to help her track her worker bees. In this first part of the project 
you’ll design the form, add the Queen and Worker classes, and get the basic system working. 

Sorwciirwcs dlass diagv»arws lis-t pv*ivatc fields -types. 


((ciSe 



Queen 


private workers: Worker[] 
private shiftNumber: int 


AssignWork() 

WorkTheNextShift() 


The program has one Queen object that manages the work being done. 

* The Queen uses an array of Worker objects to track each of the 
worker bees and whether or not those bees have been assigned jobs. 
It’s stored in a private Worker [ ] field called workers. 

* The form calls the AssignWork () method, passing a string for the 
job that needs to be performed and an int for the number of shifts. 
It’ll return true if it finds a worker to assign the job to, or 

false if it couldn’t find a worker to do that job. 

* The form’s “Work the next shift” button calls WorkTheNextShif t (), 
which tells the workers to work and returns a shift report to 

display. It tells each Worker object to work one shift, and then checks that 
worker’s status so it can add a line to the shift report. 

* Look closely at the screenshot on the facing page to see exactly 
what the WorkTheNextShif t () method returns. First it creates a 


Cuvvcr>*tJob av\A avc 

v-cad-or>ly fvopcvtics. 



Worker 


CurrentJob: string 
ShiftsLeft: int 


private jobsICanDo: string[] 
private shiftsToWork: int 
private shiftsWorked: int 

DoThisJob() 

DidYouFinishQ 


string (“Report for shift #13”). Then it uses a for loop to execute two 
if statements for each Worker in the workers [ ] array. The first if 
statement checks if the worker finsished the job (“Worker #2 finished 
the job’’). The second if statement checks if the Worker is currently 
doing a job, and if so, prints how many more shifts he’ll be working. 

The queen uses an array of Worker objects to keep track of all of the workers 
and what jobs they’re doing. 

* Current Job is a read-only property that tells the Queen object what 
job the worker’s doing (“Sting patrol,” “Hive maintenance,” etc.). If 
the worker isn’t doing any job, it’ll return an empty string. 

* The Queen object attempts to assign a job to a worker using its 
DoThis Job () method. If that worker is not already doing the job, and 
if it’s a job that he knows how to do, then he’ll accept the assignment 
and the method returns true. Otherwise, it returns false. 

* When the DidYouFinish () method is called, the worker works a 
shift. He keeps track of how many shifts are left in the current job. If 
the job is done, then he resets his current job to an empty string so that 
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he can take on his next assignment. The method returns true if the 
worker finished a job this shift; otherwise, it returns false. 


^ sWs his job as a sVm 9 . So a worker 一代。乂 

doihg a job by dkdkihg his CurrchtJob propc^y-i£ , || be wual io ah 

，h ^ h，S C# gives you easy way to do 

七 at 少 ，七/^11祕呷切 (匕針 ChtvU) will 代 Wh W { the dumhtJob 
property is either 七 y or UUhd -false otherwise. 

















inheritance 


o 


BUILD THE 

The form is pretty simple — all of the intelligence is in the Queen and Worker classes. The form 
has a private Queen field, and two buttons call its AssignWork () and WorkTheNextShif t () 
methods. You’ll need to add a ComboBox control for the bee jobs (flip back to the screenshot to 
see its list items), a NumericUpDown control, two buttons, and a multiline text box for the shift 
report. You’ll also need the form’s constructor — it’s below the screenshot. a,,,, 

^ r The ^i£hiU 

This 匕 UpDovm doir»"tv*ol is irtd 州 cd shiH queers 

,,lA/ov-kThcNc^-tShi-fiO 


Worker Bee .Assignments 
Job 


Baby bee tutoring 


Assign this job to a bee 


This is a ComboBo% 
dorrbrol 

wovkcvBccJob. Use 

i*ts pvofC\rty *to 

sc*t *tKc list, a 灼 d set 

i*ts PvopPov/rvS-tylc 
pvopcvty io 
PvopPov/hLis-t SO -the 
usev- is ohly allov/cd to 
(Moose i*tci^s -fvorw 七 he 
list C\\tk orv I 全 ems m 
the Pvo^cvtics y/'mdov/ 

•fco add all s\% jobs -to 

•the dhrop 一 dov / 灼 list 

i*tcrr\S. 

public Forml() { 

工 nitializeComponent() 
workerBeeJob•Selectedlndex 二 0. 
Worker[] workers = new Worker[4] 


□」 


Beehive Management System 




Shifts 


V 

7 




Report for shift #20 

Worker #1 will be done with 'Nectar collector' after this shift 

Worker #2 finished the job 

Worker #2 is not working 

Worker #3 is doing 'Sting patrol' for 3 more shifts 

Worker #4 is doing 'Baby bee tutoring' for 6 more shifts 

Msme this Tcx-tBox 'Vcpov-t^ 
and set its MultiLihC 
p\ropc\rty -fco tv-uc. 


workers[0] 
workers[1] 
workers[2] 
workers[3] 


new Worker(new string[] 
new Worker(new string[] 
new Worker(new string[] 
new Worker(new string[] 


rweihod, v/hidh v-ctuv-^s a 
-tha-t dojrtams the 
shi-fi v-epovt. 

Look tloscly at *tWis sW /七 
V"C^oV"t) y/Wi£.V> *tV>c 
ok\ct*t y^cv-atcs. |*t s*ta\rb 
I a sWi*f*t y\umkcv-) ay\d 
v-epov-b 4a 七 eaA 
y/ov-kcv- "is diom^. Use 
estate sc^ucirttcs w \v-\r\ *to 
ddd d Weak m 

middle a sbr\^ Voull 

y^ced bo loo\> t^v-ou^ i\\t 
y/ov-kev-s av-v-ay a^d use k 
s*ta*tcw'C^'b *to yir\cv-a*tc 
{}\t 七 e%*t. 

Hive’s Complete do^s*t\rud*to\r -fo\r 七 he -fov-m. Its 
jo*t todc -rvom *thc previous pajc- |*t also has -this 
ddd'rtio^dl I'mc sets ComboBox *to show i-ts 

-fiv-s*t i*tcm (so i*t’s y\o{, blank y/hen -fov-m loads). 

{ "Nectar collector", "Honey manufacturing" }); 

{ "Egg care ", "Baby bee tutoring" }); 

{ "Hive maintenance ", "Sting patrol" }); 

{ "Nectar collector", "Honey manufacturing ", 

'Hive maintenance ", "Sting patrol" }); 


Use a ^voupBox. 
doh*t\rol -to dv*d>/ 

d box. dirou 灼 d "the 

o-thc\r ^Oh"t\rols. Set 
七 he 七 wt or> -top o( 
"the box. usmj i-ts 
7c>c*t p\ropcv-ty. 


"Egg care", "Baby bee tutoring", 
queen = new Queen (workers) ; Youir -Poirm y/ill y\ttA a 公 ue ⑶ -field called <\uccr\. You’ll pass 七 hat av-vay 

^ 夕 o( l/Vov-kcv- object v-c-Pcv-c^dcs -to 七 he 公 uee 灼 objects do^s-tv-ud*fcov-. 


O BUIUD THE VO^EKBE AMD ^UBBM 6UASSBS. 

You’ve got almost everything you need to know about the Worker and Queen classes. There are just a couple 
more details. Queen . AssignWork () loops through the Queen object’s workers array and attempts to 
assign the job to each Worker using its DoThis Job () method. The Worker object checks its j obsICanDo 
string array to see if it can do the job. If it can, it sets its private shif tsToWork field to the job duration, its 
Current Job to the job, and its shif tsWorked to zero. When it works a shift, it increases shif tsWorked 
by one. The read-only Shif tsLef t property returns shif tsToWork 一 shif tsWorked — the queen 
uses it to see how many shifts are left on the job. 


you are here ► 
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exercise solution 



内 jRciSe 

^QLpixOH 

Shi-ftsLc-ft is d vcad-ohl 
property 七 ^akulatcs 
how ^ar\y shi-f-b avc Irf 七 

oy \ *thc duv*\rcy\*t job- 


class Worker { 

public Worker(string[] jobsICanDo) 
this•jobsICanDo = jobsICanDo; 

} 



public int ShiftsLeft { 
get { 

return shiftsToWork - shiftsWorked, 


Cuvvc^ob *»s d v-edd- 

oy\Vf 

■tells i\\t ^ttrs 
job yveedis *bo be 

T~hc <\ucch uses -the wo^kev's 

DoThisJobO method *to assi^h 

v/o\rk *to hinr \ 一 he his 

jobsfC^hDo -field h> see i-f he 
khows how *to do *thc job. 


private string currentJob 
public string CurrentJob { 
get { 

return currentJob; 


tov\sbrU{o}r just 

sets jobs|CahDo 

“Id, whidh is a stvihg 

avvay. Its pvivatc 
we W3h*t the 
^ucch *fco ask *thc wo\rkcv 
*to do a job, vathev 
w»akc hc\r eMttV whethev- 
he khows how *to do it 


private string[] jobsICanDo 
private int shiftsToWork; 
private int shiftsWorked, 



public bool DoThisJob(string job, int numberOfShifts) { 




if (!String. 工 sNullOrEmpty(currentJob)) 
return false; 
for (int i = 0; i < jobsICanDo•Length; i++) 
if (jobsICanDo[i] == job) { 
currentJob = job; 

this.shiftsToWork = numberOfShifts; 
shiftsWorked = 0; 
return true; 



return false 


lAfe used NOT ofcva*tov—*to 

dV>cdk i-f *tV>c s-tvm^ *» s NOT m\\ ov- 
cmfty. Its \ust like to see 


*!-(• somC*tVuM^ s -t3Uc 


\us*t 



TV>c <\ueev> 心 cs 七 he y/ovkcA 
PuiYcnApmiAO me 七 W *to 
*tcll *to v/ovk 七 V>c 灼 c % 七 
sKi-ft TKc mc*tKod oA^j 
vc*tuv*v>s *bruC !*(■ "t-Wis is 
vev*Y las 七 sWi-f*b 七 ha 七 s 

dom^ *tv>c job. TKa*t >wav ， 

*tV>c ®^accv> £>3^ add a 1 … c *to 
七 V>c rc\>ov*t 栎 a 七桄 C bee 

be dor\t a-fW *tWis sK'i-ft 


public bool DidYouFinish() { 

if (String. 工 sNullOrEmpty(currentJob) 
return false; 
shiftsWorked++; 

if (shiftsWorked > shiftsToWork) { 


shiftsWorked 
shiftsToWork 
currentJob = 
return true; 


0; 

0; 


else 


return false 


T^ke a dost look at the logic hc\rc. Fiys*t i*t 
dhcdks *thc du\r\rCh*tJob -field ： i-f *thc vjorktrs 
hot workihg oh a job, it jus 七 \rctu\rhs -false, 
v/hidh s*tops method- l-f ho*t ； "thch i*t 

ihd\rcmch-ts SKi-ftslA/orkcd, 3hd 七 liCh dhcdks 
f "to see i-f the job's dohC by domparihg i 七 with 
Shi-f*b7olA/b\rk. |-f it is, the method reWhS 
*brue. Othcrv/isc, it \rc*tuv*hS -false. 
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class Queen { 

public Queen(Worker[] workers) 
this.workers = workers; 

} 


private Worker[] workers; 
private int shiftNumber = 0; 



TV>c 'uc ⑶ kcc\>s Kcv- a 叫 d pivate 

because tKcyVc asst^cd, »>o otKc^r t\ass 

should be able bo 七“…饮 cw see 

tKcrn, smdC sKc s IKC oA^I or>C >/V>o ^esthem 
ov-dev-s. TKc Co^bruior scls lV>c U\A S value. 


public bool AssignWork(string job, int numberOfShifts) { 

for (int i = 0; i < workers.Length; i++) 

if (workers[i].DoThisJob(job f numberOfShifts)) 

return false; true ’ \ !Jf h ^. sh f assi 9 hs ^ ^ wo^rk^ b«s ; she sia^is with 

} the +,irst Ohc ahd tn cs assig h ih 9 him the job. ^ he 

public string WorkTheNextShift () { 1 l^ • i . 0 • >. •- nCh d DCC who d3h do 

shiftNumber++; 

string report = "Report for shift #" + shiftNumber 
for (int i = 0; i < workers.Length; i++) 


the job is 4uhd, the method Uidh sh> ? s the Lp) 

、 string report = "Kepor^ ror snift #▼' + shif tNumber + " \r\n M * 

T 

• HC ^ucch s if (workers[i] .DidYouFinish() ) 

l^oirkThcKcx-tShi-fiO , report += "Worker #" + (i + 1) + " 

method tells each 
wolrkeir *to wovk S 
shi *P*t ahd adds a 

lihe *to £hc vepovi 
dcpchdihj oh £hc 
siaius. 


finished the job\r\n"; 
if (String •工 sNullOrEmpty(workers[i].CurrentJob)) 

report += "Worker #" + (i + 1) + " is not working\r\n"; 

else 

if (workers[i].ShiftsLeft > 0) 

report += "Worker #" + (i + 1) + " is doing 、▼，+ workers [ i ] . Current Job 
+ " r for " + workers[i].ShiftsLeft + " more shifts\r\n"; 

else 

report += "Worker #" + (i + 1) + " will be done with 、，' 

+ workers[i].CurrentJob + "' after this shift\r\n"; 


return report; 

} The -fov*w\ uses rbs ^ucck> -f ield xo 

} 3 Yt^cettiCt "to 公 ucc 於 

We already gave you the constructor. Here’s the rest of the code for the form: 0 b\Cd*t ； >^WidV> m 七 uvr> V^s 

private Queen queen; ^ - * of vc-fcrcy>6cs >wovkcv objcdls. 

private void assignJob_Click(object sender, EventArgs e) { 

if (queen . AssignWork (workerBee Job . Text(int) shifts .Value) == false) 

MessageBox.Show("No workers are available to do the job '" 

+ workerBeeJob.Text + ，” n , "The queen bee says 

else 

MessageBox.Show("The job '" + workerBeeJob.Text + "' will be done in 
+ shifts.Value + " shifts ", "The queen bee says 



private void nextShift_Click(object sender, EventArgs e) 
report.Text = queen.WorkTheNextShift(); 

^e,ates a ^ it d 吶”如代七 



The assighJob buttoh ta\\s ihe 
AssighWo^kO method 

•to assijh wo\rk -to a work 饮， 

ahd displays d bo^ 

dcpchdihj Oh whether o^* hoi a 

wo\rk(^’s available to do the job. 


you are here ► 
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you’re not done 


Inheritancecross 

Before you move on to the next part of the exercise, 
give your brain a break with a quick crossword. 



Across 

5. This method gets the value of a property. 

7. This method returns true if you pass it “”. 

8. The constructor in a subclass doesn’t need the same 
_as the constructor in its base class. 

9. A control on a form that lets you create tabbed applications. 
11. This type of class can't be instantiated. 


Down 

1. A_can override methods from its base class. 

2. If you want a subclass to override a method, mark the 
method with this keyword in the base class. 

3. A method in a class that’s run as soon as it’s instantiated. 

4. What a subclass does to replace a method in the base 
class. 

6. This contains base classes and subclasses. 

7. What you’re doing by adding a colon to a class declaration. 

10. A subclass uses this keyword to call the members of the 
class it inherited from. 
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inheritance 


Use iwheritawce to extend the 
bee management system 

Now that you have the basic system in place, use inheritance to let it track how much 
honey each bee consumes. Different bees consume different amounts of honey, and 
the queen consumes the most honey of all. You’ll use what you’ve learned about 
inheritance to create a Bee base class that Queen and Worker inherit from. 








激以 t 以 4 丄 ^ r 11 

W tLa,dsele,U^^s f 伽 a 心“脚 - 

^ ? vo\e^s -folder, a^d add i ? J ^ , (1 ^ cdA ca6 v> 6lass Ut 

r u It)6 Will NOT 己時如卞即 ”， J_sure ^ add its dcs»( 



rt arc a 伽呼 ^ 

57 心 bolder, a^d add ^ ^{ u \ 0 WH ^eed ^ ^ ^ ^ 

L, 眯弋 N0 V= taTv^d a L, ^ add ^ des^ev 


































we r re all just bees 


§1^ 

Ei(ef(ciSe 


We’re not done yet! The queen got a call from her accountants, who told her she needs to keep track 
of how much honey the hive is spending on its workers. Here’s a perfect chance to use your new 
inheritance skills! Add a new Bee superclass and use it to calculate honey consumption for each shift. 


O DEBATE THE BBB 6UASS AMD MODIFY ^UBBN AMD JO EXTEND IT. 

The Bee class has a HoneyConsumptionRate () method that calculates how much honey the 
bee uses per shift. Your job will be to modify the Worker and Queen classes to extend it. 


class Bee { 

public const double HoneyUnitsConsumedPerMg = .25; 

public double WeightMg { get; private set; } 

public Bee(double weightMg) { 

WeightMg = weightMg; 《 

} 

virtual public double HoneyConsumptionRate() 
return WeightMg * HoneyUnitsConsumedPerMg 


❺ MODIFY THE ^UBSM AMD 6UASSBS TO SXTgMD BBB. 

The Queen and Worker classes will inherit the basic honey consumption behavior from 
their new parent Bee superclass. You’ll need to set up their constructors to call the base class 
constructor. 


丁 he Bcc ^ohstv-ud-fcov -takes 

the weight 
the bcc ih rMiHi^arMS ； 
whi 匕 h is used \v\ the bdse 
hohey dohsumptioh dakulaiioh. 


* Modify the Queen class to extend Bee. You’ll need to add a double parameter called 
weightMg to the constructor that gets passed back to the base constructor. 

* Modify the Worker class to extend Bee, too — you’ll need to make the same modification fx 

to the Worker constructor that you did for the Queen. ‘ 

frmt you use u docs d 60 ⑽ tru 如 / error 

wssay you saw earlWm 七 ^ *to your adva^-ta^c! Have i\\t 

Wovkcv dldss *mKcvi*t -fv-om Bcc, build y 敵 pv-ojedt 

Ipg displays -tKc doublc-tlitk \i av>d IPS Will 

vi^K*t *to {}\t iVovkcv doir>s*tvud*tov- au*tor«atitally- H ■ 。如⑼七 . 



MODIFY THE F^RM TO INITIALIZE THE ©UBBM AMD WORKERS WITH THBIR WEIGHTS. 

Since you changed the Queen and Worker constructors, you’ll also need to change the form’s 
constructor so that when it creates its new Worker and new Queen instances, it passes the additional 
weights into their constructors. Worker #1 weighs 175mg, worker #2 weighs 114mg, worker #3 weighs 149mg, 
worker #4 weighs 155mg, and the queen weighs 275mg. 

(Your code should now compile.) 
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^VBERIDB THE VOORKEE’S H^Ney^NSUMPTi^NEATeO METHOD 

The Queen consumes honey just like the base Bee class. And workers consume the same 
amount of honey...but only while they’re idle! When they’re working a shift, they consume .65 
additional units for each shift they worked so far. 

This means that the Queen can use the base HoneyConsumptionRate () method 
that she inherits from her Bee superclass, but the Worker will need to override the 
method to add the additional .65 units per shift worked. You can also add a constant called 
honeyUnitsPerShif tWorked to make it really clear exactly what this method is doing. 

You can use the IDE to get started. Go to the Worker class and type “public override ” 一 
when you add the space, the IDE will automatically list all the methods you can override: 

public override 

® Equals [object obj) 

© GetHashCodeQ 


Hon ey Con sym ptionRateO 


© ToStringO 


double Bee.HoneyConsumptionRateQ 


Choose the HoneyConsumptionRate () method from the IntelliSense window. When 
you do, the IDE will generate a method stub that just calls the base method. Modify your new 
method so that it starts with the output of base . HoneyConsumptionRate () and then 
adds the extra .65 units consumed per shift worked. 



ADD CONSUMPTION TO THE SHIFT REPORT. 

You’ll need to modify the Queen’s WorkTheNextShif t () method to keep track of the 
honey consumed by the Queen object and each of the Worker objects, calling each object’s 
HoneyConsumptionRate () method and adding it to a total. Then it should add this line to 
the end of the report (replacing XXX with the number of units of honey consumed): 


Total honey consumed for the shift: XXX units 





u sKould be able bo do i\\\s by 
ddd'm^ jus 七七 Wee Imcs o-f dodc *to 


Since all bees have a HoneyConsumptionRate () method, and 
the Queen and Worker are both Bees, shouldn’t there be a single, 
consistent way to call that method for any Bee object, no matter what 
kind of Bee it is? 


you are here ► 
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exercise solution 



汽 购鉍 
§OL}itlOH 


The dor\s*tvud*fcov ^c*U a v>c>w pavarwetev-, 
y,KitK *i*t passes badk bo *tKc base 
tov>s*tv-ud*tov-. TV>IS lc*ts -tKc -fov-m 
object v/i 七 ii i\\t bees y/ci^Kt 


class Worker : Bee 


S/ 


public Worker(string[] jobsICanDo 

: base(weightMg) 

{ 

this•jobsICanDo = jobsICanDo; 


double weightMg) 


const double honeyUnitsPerShiftWorked = .65; 

public override double HoneyConsumptionRate() 

{ 

double consumption = base•HoneyConsumptionRate(); 
consumption += shiftsWorked * honeyUnitsPerShiftWorked 


return consumption; 




The Wovkcir dass ovemvidcs -the HcweyCo 的 s_pticmRateO 
七 hod "to sdd "tliC dddi 七 iohdl ho^cy £.or>surw^*tior> -Po\r bcc 
乙 uirreKrtly do'm^ d job. 

// The rest of the Worker class is the same 

// ... 



public Forml() 


七 dhahacd— the 

vest o\ the is exactly the same. 


InitializeComponent(); 
workerBeeJob.Selectedlndex = 0; 
Worker[] workers = new Worker[4]; 
workers[0] = new Worker(new string[] 
workers[1] = new Worker(new string[] 
workers[2] = new Worker(new string[] 
workers[3] = new Worker(new string[] 
"Egg care", "Baby bee tutoring ", 
queen = new Queen(workers, dzB )； 


Inkeritance 
made it less 
work lor you 
to upetate your 
cocte and add 
tke new koney 
consumption 
tekavior to 
tke Queen and 
Worker classes. 
It would kave 
been a lot 
karder to make 
tkis ckange li 
you’d kact a lot 
oi duplicatect 
cocte. 


"Nectar collector’，，"Honey manufacturing" }, 
"Egg care", "Baby bee tutoring" }/Q.14) 

"Hive maintenance" , M Sting patrol" 

"Nectar collector，'，"Honey manufacturing ", 
'Hive maintenance，'，"Sting patrol" } , \^55^; 


TKc oy>ly *to *tKc -fovm is *tKa*t 
— v/ci^Kis Y\ttd *to be added to i\)t 1/Vov-kcv a^d 

6 l\Attr\ £.ov>s*tvu£.*fcovs. 
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class Queen : Bee 

{ 

public Queen(Worker[] workers, double weightMg) 
: base(weightMg) 

{ 

this.workers = workers; 


The 没 ucc/s ^o^s*t\rud*fco\r 
-the same 

ds *thc lA/ov-kcv-^s does. 


private Worker[] workers; 
private int shiftNumber = 0; 

public bool AssignWork(string job, int numberOfShifts) 

{ 

for (int i = 0; i < workers.Length; i++) 

if (workers[i].DoThisJob(job f numberOfShifts)) 
return true; 
return false; 



TiVis todt is *tKc 
same as bc-fovc- 


public string WorkTheNextShift() 

{ 

double honeyConsumed = HoneyConsumptionRate(); 



shiftNumber++; 

string report 二 "Report for shift #▼' + shif tNumber 
for (int i = 0; i < workers.Length; i++) 


The dakulatior^ r^ccds 

-to siari v/i 七 ^ttr!s t\Arrtv\i 
Kor>cy dov>sump*ti( 




r\n’ 


This dodc also 
stays c%ad*tly 
same. 


M the rweihod loops ihiroujh eadh 
honeyConsumed += workers [i] . HoneyConsumptionRate () ; v/oirkeir, i*t adds -that woirkeir’s 

demsumptiem 七 o 七 he "total. 

if (workers[i].DidYouFinish()) 

report += "Worker #" + (i + 1) + " finished the job\r\n"; 
if (String •工 sNullOrEmpty(workers[i] .CurrentJob)) 

report += "Worker #" + (i + 1) + " is not working\r\n M ; 

else 

if (workers[i].ShiftsLeft > 0) 

report += "Worker #" + (i + 1) + " is doing 、 n + workers[i].CurrentJob 
+ " r for " + workers[i].ShiftsLeft + " more shifts\r\n"; 

else 

report += "Worker #" + (i + 1) + " will be done with 、 n 
+ workers[i].CurrentJob + " r after this shift\r\n"; 


report += "Total honey consumed for the shift: " + honeyConsumed + ’▼ units\r\n M 

v/ovkc^s Imc IS ddded "to vcfov*t> 
i\yt <\\AttY\ jus 七 r^ccds bo add or\t last Tmc 
*to*tal Ko^cy doy>sumcd -fov 


return report; 


you are here ► 
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crossword solution 



Inheilfancecross Solution 
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nterfaces and abstract classes 




+ Making classes 
keep their promises 





Actions speak louder than words. 

Sometimes you need to group your objects together based on the things they can 
do rather than the classes they inherit from. That’s where interfaces come in — they 
let you work with any class that can do the job. But with great power comes great 
responsibility, and any class that implements an interface must promise to fulfill all of 
its obligations...or the compiler will break their kneecaps, see? 


this is a new chapter 
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family trees for classes of bees 


Let's get back to bee - sics 


The General Bee-namics corporation wants to make the 
Beehive Management System you created in the last chapter 
into a full-blown Hive Simulator. Here’s an overview of the 
specification for the new version of the program: 



Crpnerd Bee - nannies Hive Simobfon 

To better represent life m the hive, we II need to add specialized 
capabilities to the worker bees. 

• Ml bees consonne honey and have a weight. 

• Qoeens assign work, monifon shift reports, and tell workers to 
work the next shift. 

• All worker bees work shifts. 

gf in g patrol bees will need to be able to sharpen them stingers, 

look for enemies, and sting them. 

Nectar collect or bees are responsible for finding flowers, 
gathering nectar, and then netonning to the hive. 


Bee a„d Wo^ 
do^i | ook like 

11 

，匕扣 e^d ih c 

Classes wc alircady 
一； h h ^dle iht 

hCW 士 dcs. 


>csc 


Looks lik well heed io be able io 

如 代 di-fWh-t data -Po\r the wo^kcir 
bccs depchdihg oh -the job they do. 


Lots of things are still the same 

The bees in the new Hive Simulator will still consume honey 
in the same way they did before. The queen still needs to be 
able to assign work to the workers and see the shift reports 
that tell who’s doing what. The workers work shifts just like 
they did before, too; it’s just that the jobs they are doing have 
been elaborated a little bit. 
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interfaces and abstract classes 


Wc caw use mhcritawccto create 
classes for different types of bees 


Here’s a class hierarchy with Worker and Queen classes 
that inherit from Bee, and Worker has subclasses 
Nectar Co Hector and StingPatrol. 


Wcire s 

aboui 

wci 9^ hohey 

is sUed 


fs whc^-c all 

彳七卜 ih4irh,^i wl 

Wolr ‘ 3 shi-Pt 

is kepi 




R^bcir how -the n ucch 
hC L cdcd cx ^ Wy? fW s 

: h 的 ov C ^ oc ( c ^ 

一 yCohsu 呷仏 hO method. 


TVis is *ti^c r\cv/ 
sub^ldsses y/ill look like- 





\ 


StinaPatrol 


NectarCollector 

StingerLength 

AlertLevel 


Nectar 

SharpenStinger() 


FindFlowers() 

LookForEnemiesO 


GatherNectar() 

Sting() 


ReturnToHiveQ 



And these dasscs J 
hold J^ ^o^i IOh 

p 扣 *to C 此 h job. 


Worker 


Worker 


Queen 

Job 


Worker[] 

ShiftsToWork 


ShiftNum- 

ShiftsWorked 


ber 

ShiftsLeft 



DoThisJobf) 


AssignWork() 

WorkOneShiftQ 


WorkTheNextShiftf) 



HoneyConsumptionQ 


class StingPatrol 

i public int AlertLevel { get; private set 
public int StingerLength { get; set; } 
public bool Sharpenstinger (int Length) 




public bool LookForEnemies(){...} 
public void Sting(string Enemy){... 


class NectarCollector : Worker 

{ 

public int Nectar { get; set; 
public void FindFlowers (){... 
public void GatherNectar(){... 
public void ReturnToHive(){... 



What happens if you have a bee that 
needs to sting and collect nectar? 


you are here ► 
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interfaces for jobs 


Aw interface tells a class that it must 
implement certain methods and properties 

A class can only inherit from one other class. So creating two separate subclasses for 
the StingPatrol and Nectar Co Hector bees won’t help us if we have a bee 
that can do both jobs. 

The queen’s Def endTheHive () method can only tell StingPatrol 
objects to keep the hive safe. She’d love to train the other bees to use 
their stingers, but she doesn’t have any way to command them to attack: 


class Queen { 

private void DefendTheHive(StingPatrol patroller) { ... } 



You use an 
interface to 
require a class 
to include all 
of tke inetkocfs 
ami properties 
listect inside tke 
interface—il 
it doesn’t，tke 
compiler will 
tkrow an error. 


There are Nectar Co Hector objects that know how to collect nectar from flowers, and instances 
of StingPatrol that can sharpen their stingers and patrol for enemies. But even if the queen could 
teach the NectarCollector to defend the hive by adding methods like SharpenStinger () and 
LookForEnemies () to its class definition, she still couldn’t pass it into her Def endTheHive () 
method. She could use two different methods: 


private void DefendTheHive(StingPatrol patroller); 

private void AlternateDefendTheHive(NectarCollector patroller) 


But that’s not a particularly good solution. Both of those methods 
would be identical, because they’d call the same methods in the objects 
passed to them. The only difference is that one method would take a 
StingPatrol, and the other would take a NectarCollector 
that happens to have the methods necessary for patrolling the hive. And 
you already know how painful it is to maintain two identical methods. 

Luckily, G# gives us interfaces to handle situations like that. 
Interfaces let you define a bunch of methods that a class must have. 

An interface requires that a class has certain methods, and the way 
that it does that is by making the compiler throw errors if it 

doesn’t find all the methods required by the interface in every class 
that implements it. Those methods can be coded directly in the class, 
or they can be inherited from a base class. The interface doesn’t care 
how the methods or properties get there, as long as they’re there 
when the code is compiled. 
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^tv\ i-f 3das s*tm^ p3"tv"ol r«C*t^ods 

-to a Ncd*t 3 v-Collcd*tov- objcd*t> sKc still *t 
pass *to Kcv Pc-fc^dTiicH'ivcO method 
bcdausc *i*t a Stm^Paivol 

just sti d Stm^Pa-tvol 
e«\ual *to a Nc^tav-Collcd-tov- objedt a 



dould add a stCov\A method called 
AI*tcv"r\a*tcPc-f 七 a 

Kcd*t3V"Collc£.*toV" \rc-fc\rcr\dc ms*tcad> bu*t v/ould 

be *to v/ovk W\i\\- 



Plus, -the Dc-PchdThcttivcO a^d 
Al'tcv^a'tcPc-fchdTIicH'ivcO nr»c*thods would be ideh 七 iddl 
-Pov the type o( -the pavametev*. I-P she v/ahted 
■to tcath the BabyBccCavc o\r Mai” 七 ⑶ awe objects -to 
defend the hive, she'd r>ccd -to keef addi% hew methods, 
a nr»css/ 



interfaces and abstract classes 


Use the interface keyword to define m interface 


Adding an interface to your program is a lot like adding a class, 
except you never write any methods. You just define the methods’ 
return type and parameters, but instead of a block of statements 
inside curly brackets, you just end the line with a semicolon. 

Interfaces do not store data, so you can’t add any fields. But 
you can add definitions for properties. The reason is that get and set 
accessors are just methods, and interfaces are all about forcing classes 
to have certain methods with specific names, types, and parameters. 
So if you’ve got a problem that looks like it could be solved by adding 
a field to an interface, try using a property instead ~odds are, it’ll 
do what you’re looking for. 

interface IS tingPatrol 


I 士 \rfa “ r^awes stav 七…狀工 

vou ⑽ a 七 … you should make 
starU 舳扣 i- TKcc s ,ulc 

tKal says you ,eed do ^ Ut it ^ you, dode 
a Id easie, -to ^ ^ see ^ 

tKe m ^ a， V Wank Ime mside a.y WWW 
切 ? c T - U 以 sc sW 獻 1 士山⑽ 


\/ou dctlavc 

V>kc *tW»s ： 



d ‘ 七 ‘ c , 

ds bui ihey ^ 
P^opc^rtics. 

/\^y dlass *tKa*t implcmcr>*ts 
•this *m*tcv--fadc will Y\tt& 3 
SV>av-pcy>S*tm^cv*() me 七 hod 七 ha 七 
-bdkes dv>’m 七 fav-amc*tcv-. 


int AlertLevel { get;} 

int StingerLength { get; set;} 

bool LookForEnemies(); 

int Sharpenstinger(int length) 



—ihai 

i^plcnr»Ch-b this 

^ ^ of these 
methods ahd 

P'ropc^rtics, ov- -the 

P 哼如 
^or^pilc. 


interface INectarCollector 


void FindFlowers(); 
void GatherNectar() 
void ReturnToHive() 



So how does this help the queen? Now she can make one single method that takes any 
object that knows how to defend the hive: 


/ a - CoAt 

tZt t\ass tV>at •— ⑽扣 . 

lf\ v/ ,,w i y A 

Every tiring in a 
putlic interlace 


private void DefendTheHive(IStingPatrol patroller) 


f ^ ，S ah IStihgPat\rol \rc-fc\rchdc, you Cav\ pass i-t 
object that irwplcmch-b (SirngPol-tv-ol. 


This gives the queen a single method that can take a StingPatrol, NectarCollector, 
and any other bee that knows how to defend the hive — it doesn’t matter which class she passes 
to the method. As long as it implements 工 StingPatrol ， the DefendTheHive () method 
is guaranteed that the object has the methods and properties it needs to defend the hive. 


is automatically 
public, because 
you’ll use it to 
cteline tke public 
itietkocis anct 



erties ol 


0 


Q 


NOW) THAT I KbiOVJ YOU 6AN 
DBFBND THE HIVB, AUU 

BB A UOT SAFBEi 


prop 
any class tkat 
implements it. 


n o\)f 
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a little bit nectarcollector and a little bit stingpatrol 


thereicire no o 

Dumb Questi9ns 


Now you can create aw mstance of 
NectarStiwger that does both jobs 


You use the colon operator to implement an interface, just like 
you do for inheritance. It works like this: the first thing after the colon 
is the class it inherits from, followed by a list of interfaces — unless it 
doesn’t inherit from a class, in which case it’s just a list of interfaces 


(in no particular order). This dass ⑽ 

You 七 By\ m-tcv-Padc y/i-th d dolors '^plcrwCh-ts | /V tt{^rCo\\tc{x>>r dr>d 

opc\rd*to\r, jus-t like you mhcv"it ^ |StmjRa-( ： v*ol. ^ 

class NectarStinger^T)WorkeiQ INectarCollector^ 
IStingPatrol { 

TV (vfcd'tav^t • 呼 v putdic int AlertLevel 

{ get; private set; 

miev-fates, so \i 


yvccds all -bV^c 

w\c*b^ods a 矜 d 

▽voperbes -fv-ow 

caA of 七 W. 


public int StingerLength 
{ get; set; } 


You use 
wove or\t 

sc^av-a-tc *t^cw 

Y/\*bV\ towwas. 


public int Nectar { get; set; 


public 

tve” public 

*m *bV\c m*tcv^c 厂 

V^as a wc*b^od V {. . .} 

m i\\t dlass. 7 public 
0*t^cvWisc \i public 

Y/ould^*t tow^lc. ^public 


bool LookForEnemies() {...} 

int Sharpenstinger(int length) 

void FindFlowers() {...} 
void GatherNectar() {...} 

void ReturnToHive() {...} 


Vou tv-calc a Nc^Stmacv okjett, 

• • 七 』 kc able to do 如 ) 。 l) J a 

Kc^Collc^ ar,d a Stm^Patrol bcc 


When you’ve got a class that implements an interface, it acts just like 
any other class. You can instantiate it with new and use its methods: 

NectarStinger bobTheBee = new NectarStinger(); 
bobTheBee.LookForEnemies(); 
bobTheBee.FindFlowers(); 


This is one of the tougher concepts to get into your brain. 
If it’s not quite clear yet, keep reading. We’ll have lots of 
examples throughout the chapter. 
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I still don’t quite get how interfaces improve 
the beehive code. You’ll still need to add a 
NectarStinger class, and it’ll still have 
duplicate code...right? 

Interfaces aren’t about preventing you from duplicating 
code. They’re about letting you use one class in more 
than one situation. The goal is to create one worker bee 
class that can do two different jobs. You'll still need to 
create classes for them—that’s not the point. The point 
of the interfaces is that now you’ve got a way to have 
a class that does any number of jobs. Say the Queen 
has a PatrolTheHive () method that takes a 
StingPatrol object and a CollectNectar () 
method that takes a NectarCol lector object. 

But you don’t want StingPatrol to inherit from 
NectarCollector or vice versa—each class has 
public methods and properties that the other one shouldn't 
have. Now take a minute and try to think of a way to create 
one single class whose instances could be passed to both 
methods. Seriously, put the book down, take a minute and try 
to think up a way! How do you do it? 


Interfaces fix that problem. Now you can create an 
IStingPatrol reference—and it can point to any 
object that implements IStingPatrol, no matter what 
the actual class is. It can point to a StingPatrol ， or 
a NectarStinger, or even a totally unrelated object. 

If you’ve got an IStingPatrol reference pointing to 
an object, then you know you can use all of the methods and 
properties that are part of the IStingPatrol interface, 
regardless of the actual type of the object. 


But the interface is only part of the solution. You'll still need to 
create a new class that implements it, since it doesn’t actually 
come with any code. Interfaces aren’t about avoiding the 
creation of extra classes or avoiding duplicate code. They're 
about making one class that can do more than one job without 
relying on inheritance, as inheritance brings a lot of extra 
baggage—you’ll have to inherit every method, property, and 
field, not just those that have to do with the specific job. 

Can you think of ways that you could still avoid duplicating 
code while using an interface? You could create a separate 
class called Stinger or Proboscis to contain 
the code that’s specific to stinging or collecting nectar. 
NectarStinger and NectarCol lector 
could both create a private instance of Proboscis, and 
any time they needed to collect nectar, they'd call its methods 
and set its properties. 









interfaces and abstract classes 


Classes that implement interfaces have to 
include ALL of the interface's methods 

Implementing an interface means that you have to have a method in the class 
for each and every property and method that’s declared in the interface — if it 
doesn’t have every one of them, it won’t compile. If a class implements more 
than one interface, then it needs to include all of the properties and methods i 
each of the interfaces it implements. But don’t take our word for it … 

O CIS5AT5 A bJBW! CObiS^UB APPLICATION AbJt> At>t> A NBW! CUASS FlUB 
CAUUBl> IStinc^Pat^u 

The IDE will add a file that has the line class IStingPatrol as usual. Replace that line 
with interface IStingPatrol, and type in the IStingPatrol interface from two pages 
ago. You’ve now added an interface to your project! Your program should now compile. 

❺ At>t> A Bee CUASS T^> THB P 故 J5CT- 

Don’t add any properties or methods yet. Just have it implement IStingPatrol: 
class Bee : IStingPatrol 


O my to co/^piue thb pe ⑽ bam- 

Select Rebuild from the Build menu. Uh oh — the compiler won’t let you do it: 



Error List 


©4 Errors 


! 0Warnings 


0 Messages 


Description 


Search Error List 
File ▲ Line 


P 


1 ch07_Bee_lnteffaces.Bee' does not implement interface member ■ch07_Bee_ln,terfaces.lStEn:gP l atroLSih.airpenStinger(Snl} 1 Bee.cs 


❿ 2 1 ch07_Bee_lnterfaces.Bee' does, not implement interface member , ch07_Bee_lnterfaces.lStingPatrol,LookForEnemiesO , Bee.cs 9 

©3 1 c h07_B ee_l nterf a c es. B ee' does, not implement interface member l ch07_Bee_lnterfaces.lStingPatrol,Sting erLength 1 Bee.cs 9 

❿ 4 'c h07_B eej nterfaces. Bee' does, not implement i nterf a ce member 'c h07_B ee_l nterf a c es. I Sti n g P atrol , Al ert 1 evel' Bee.cs 9 

Error List Output 


Column 

11 
11 
11 


•丄 -〜 


O At>t> THB MBTH^OS AMO PR£>PBRTieS T6> THB 8BB CUASS^ 

Add a LookForEnemies () method and a SharpenStinger () method. Make sure that their signatures 
match the ones in the interface — so LookForEnemies () has to return a bool, and SharpenStinger () 
takes an int parameter (choose any name) and returns an int; they don’t have to do anything for now, so 
just return dummy values. Add an int property called Alert Level with a get accessor (have it return any 
number), and an automatic int property called Stinger Length with get and set accessors. 


One more thing: make sure all the Bee members are marked public. Now the program will compile! 


you are here ► 
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clowning around 


fret a little practice using interfaces 


Interfaces are really easy to use, and the best way to understand them is to start 
using them. So create a new Console Application project and get started! 



thi 


IS ， 


Here’s the Tall Guy class, and the code for the Main () method in Program, cs that instantiates it using an 
object initializer and calls its TalkAboutYourself () method. Nothing new here — we’ll use it in a minute: 


class TallGuy { 

public string Name; 
public int Height; 

public void TalkAboutYourself() { 

Console.WriteLine("My name is " + Name + " and I'm 
+ Height + " inches tall."); 


static void Main(string[] args) { 

TallGuy tallGuy = new TallGuy() { Height = 74, Name = "Jimmy" }; 

tallGuy.TalkAboutYourself(); 


❺ 


You already know that everything inside an interface has to be public, but don’t take our word 
for it. Add a new I Clown interface to your project, just like you would add a class: right-click on 
the project in the Solution Explorer, select Add^New Item... and choose Interface. 

Make sure it’s called 工 Clown . cs. The IDE will create an interface that includes this declaration: 

interface IClown 


Now try to declare a private method inside the interface: 

private void Honk(); 

Select Build^Build Solution in the IDE. You’ll see this error: 



^ ou -to type w p u bli^ w 

the because 

•七 automa-ti^ally evevy 

ahd method public 



Now go ahead and delete the private access modifier — the error will go away and your 
program will compile just fine. 



Before you go on to the next page, see if you can create the rest of the IClown interface, 
and modify the TallGuy class to implement this interface. Your new 工 Clown interface 
should have a void method called Honk that doesn’t take any parameters, and a string 
read-only property called FunnyThinglHave that has a get accessor but no set accessor. 


300 


Chapter 7 







interfaces and abstract classes 



Here’s the interface — did you get it right? 


interface 工 Clown 

{ 

string FunnyThinglHave { get; } 

void Honk(); 



flcvc s example o-p 

"that has a get a^dcssov- v/i-tliout a 

匕七 doht^ih -f ields, but whe^ you 

七 this \rc3d—Ohly p\roPcV"*ty ih 
a ^ look like a -field {p O 七 h 饮 

objed*ts. 


OK, now modify the Tall Guy class so that it implements 工 Clown. 
Remember, the colon operator is always followed by the base class to inherit 
from (if any), and then a list of interfaces to implement, all separated by 
commas. Since there’s no base class and only one interface to implement, 

the declaration looks like this: 〆… .n . , , 

，咖〜 y Wl| | … pU ehUhe /Clow, 

class TallGuy :工 Clown 

Then make sure the rest of the class is the same, including the two fields 
and the method. Select Build Solution from the Build menu in the IDE to 
compile and build the program. You’ll see two errors, including this one: 


c. 


WKa-b -bV^c IPt is tcllmj 

you is you said 

Tall^uy would 
|Clowr\, you f\rom*iscd *to 

add all yoferbie! 
a^d methods m *b^a*t 
m*bcv-fa^...a^d i^tv\ you 
broke *tKa*b pv-om'isef 





The errors will go away as soon as you add all of the methods and properties 
defined in the interface. So go ahead and implement the interface. Add a read¬ 
only string property called FunnyThinglHave with a get accessor that always 
returns the string "big shoes Then add a Honk () method that writes “Honk 
honk!” to the console. . a dlass 

__ ^ ■…』 ^#4-u\rv\S S. 

public string FunnyThinglHave 


Here’s what it’ll look like: 


s\x \^ 亡 叫 




get { return "big shoes 


public void Honk() { 

Console.WriteLine("Honk honk!") 


e { \ ^ do *tW»s, ^ " 

;} 

-jovk I r 

I he mtc\r+adc says thoi-t you heed a public. 

void method called Hohk, bu-t \i docs^i say 

山七七 hat method heeds -to do. H cat\ do 

at ^11—ho what it docs, -the 

to&t will Compile 3s loh^ ds some rwethod is 
thc\rc with the \right sigK>atuv-c. 



Now your code will compile! Update your Main () method so that 
it calls the TallGuy object’s Honk () method to print the “Honk 
honk!” line to the console. 
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interfaces don’t make objects 


You caw't mstawtiatG aw interface. 


but you can reference aw mtcrfacc 

— ■_ 

Say you had a method that needed an object that could perform 
the FindFlowers () method. Any object that implemented the 
INec tar Co Hector interface would do. It could be a Worker 
object, Robot object, or Dog object, as long as it implements the 
INec tar Co Hector interface. 

That’s where interface references come in. You can use one 
to refer to an object that implements the interface you need 
and you’ll always be sure that it has the right methods for your 
purpose — even if you don’t know much else about it. 

This won’t work... 



)U ^ ⑽ a 七 c a” a^av 

but 7 ou msta^atc a, 

But 7 ou ^ do u pomt 

^osc 代 o^r passes 

object! 


W»ll to—am. 


IStingPatrol dennis = new IStingPatrol(); 


❺ 1 Cannob create an instdnee ： of l=he absliracl: class or inberPace \ 


You can’t use the new keyword with an interface, which makes sense — the 
methods and properties don’t have any implementation. If you could 
create an object from an interface, how would it know how to behave? 




hov/ you 〉 
dould pass a BLT 
vt(crtY\tt m*to a^y 
dlass *tha 七 a 

Sa 灼 dwidh, because BLT 

mhcvrts -Pvom Sar>dwidh? 
Well, this is -the same 
— you use B 

\y\ a^y 


■but this will. 

NectarStinger fred = new NectarStinger() 
IStingPatrol george = fred; 它此““吵咖 

The first line is an ordinary new statement, creating a reference called object 

Fred and pointing it to a NectarStinger object. 


s 


wove ， 


The second line is where things start to get interesting, because that line of 
code creates a new reference variable using IStingPatrol. That 
line may look a little odd when you first see it. But look at this: 

NectarStinger ginger = fred; 


V OVA 

use 

vcWw 7 ou 你垮 
V\dve kfi 

七 methods m 


method ov 
|S*t'm^Pa*tv"ol. 


You know what this third statement does — it creates a new NectarStinger 
reference called ginger and points it at whatever object fred is pointing to. 
The george statement uses IStingPatrol the same way. 


FRED 


So what happened? 

There’s only one new statement, so only one object was created. The 
second statement created a reference variable called george that can 
point to an instance of any class that implements IStingPatrol. 



302 


Chapter 7 








interfaces and abstract classes 


Interface references work just like object references 


You already know all about how objects live on the heap. 

When you work with an interface reference, it’s just another 
way to refer to the same objects you’ve already been using. 

O OBJBCTS ARB CiaBATBt> AS USUAL. 

Both of these classes implement 工 StingPatrol. 

StingPatrol biff = new StingPatrol(); 

NectarCollector bertha = new NectarCollector (); 

Lc*t s assume that S*t'mgPa*b\rol implements the 
istmjpat^rol Kc^WCollc^-tov- 

implements -the IKc^tav-ColIcd*tov 




O IStin^Pat^u ANt> INecra^CoLLBcro^ 

^eFB^ences^ 

You can use interface references just like you use any other 
reference type. 

工 StingPatrol defender = biff; 

工 NectarCollector cutiePie = bertha; 

TV^csc two use -to 

v\t>N vc-fcvc^^cs *to objects- Y ou 

oA) pom 七扣 m-tev-fa^ Yt^ectY^u at 
ms-ba^C d dass i\\^i implcmcr\*ts it 

O ^ II^TBiaFACB VJIUU KBBP AbJ 

OBJECT AUVB^ 

When there aren’t any references pointing to an object, it 
disappears. But there’s no rule that says those references all have 
to be the same type! An interface reference is just as good as an 
object reference when it comes to keeping track of objects. 







’"9Po^ 






biff = null; This obje 匕七 did" 七 disappeair, 

because Dc-Pc^dcv is s-till 
pomtmj -fco it 

ASS 尥 N A HBVJ IHSTANCB TO AbJ INTBjaFACB 
RBFBRBbJCB^ 

You don’t actually need an object reference — you can create a new 
object and assign it straight to an interface reference variable. 

INectarCollector gatherer = new NectarStinger (); 
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we 1 re expecting a big inheritance 

You caw find out if a class implements 
a certain interface with "is" 

Sometimes you need to find out if a certain class implements an interface. Suppose 
we have all our worker bees in an array, called Bees. We can make the array hold 
the type Worker, since all worker bees will be Worker classes, or subclasses of 
that type. 

But which of the worker bees can collect nectar? In other words, we want to know 
if the class implements the INec tar Co Hector interface. We can use the is 
keyword to find out exactly that. 



AH the wo\rkc\rs av-c ih av\ 
Worleys. Wc\\ use 

IS ‘ out whidh type o-p 
>wo\rkc\r eadk bee is. 


dll 


t 


Worker[] 
bees[0] : 
bees[1] : 
bees[2] : 
for (int 


bees = new Worker[3]; 

: new NectarCollector() 

: new StingPatrol(); 

: new NectarStinger(); 
i = 0; i < bees.Length; i++) 


bccs a 丄 

l\yWc 仫 咖 a 

JUt 中卞 So 二 

loo ? 如 a 叫， 

wC tWs a^d ? vo ? e^cs to 
do job. 




if (bees[i] 



INectarCollector) 




bees [i] .DoThisJob("Nectar Collector 


v>ct*tav 





tJiereiare no 

■ Dumb Questi9ns — 

Wait a minute. When I put a 
property in an interface, it looks just 
like an automatic property. Does 
that mean I can only use automatic 
properties when I implement an 
interface? 

No, not at all. It's true that a 
property inside an interface looks very 
similar to an automatic property—like 
Job and Shif tsLef t in the 
I Worker interface on the next page. 
But they’re definitely not automatic 
properties. You could implement Job 
like this: 

public Job { 

get; private set; 


You need that private set, because 
automatic properties require you to 
have both a set and a get (even if 
they’re private). But you could also 
implement it like this: 

public Job { 
get { 

return "Accountant' 


and the compiler will be perfectly 
happy with that, too. You can also add 
a set accessor—the interface requires 
a get, but it doesn’t say you can’t have 
a set, too. (If you use an automatic 
property to implement it, you can 
decide for yourself whether you want 
the set to be private or public.) 


If you have some other class that doesn’t inherit from Worker but does implement the 
INectarCollector interface, then it’ll be able to do the job, too! But since it doesn’t 
inherit from Worker, you can’t get it into an array with other bees. Can you think of a 
way to get around the problem and create an array with both bees and this new class? 
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interfaces and abstract classes 


Interfaces caw inherit from other mtcrfaccs when we draw an 

interface on a class 


When one class inherits from another, it gets all of the methods and 
properties from the base class. Interface inheritance is simpler. 

Since there’s no actual method body in any interface, you don’t have 
to worry about calling base constructors or methods. The inherited 
interfaces simply accumulate all of the methods and properties from 
the interfaces they inherit from. 

^ - lAfe’ve tv-ca-tcd a 

interface IWorker 


diagram, we’ll show 
inheritance using 
dashed lines. 


string Job { get; } 
int ShiftsLeft { get; 


•mV^vi 七 -fv-om 




(interface) 

IWorker 


Job 

ShiftsLeft 


DoThisJob() 

WorkOneShiftQ 


void DoThisJob(string job, int shifts); 
void WorkOneShift(); 


Any class that implements an interface that inherits 
from IWorker must implement its methods and properties 

When a class implements an interface, it has to include every property and 
method in that interface. And if that interface inherits from another one, then all 
of those properties and methods need to be implemented, too. 



(interface) 


(interface) 

IStingPatrol 


INectarCollector 

StingerLength 

AlertLevel 


Nectar 

SharpenStinger() 


FindFlowers() 

LookForEnemiesf) 


GatherNectar() 

ReturnToHive() 


interface IStingPatrol : IWorker 

{ 

int AlertLevel { get;} 

int StingerLength { get; set;} 

bool LookForEnemies(); 

int Sharpenstinger(int length); 


• jut the methods pv-opcv-tics 

the |l^o\rkc\r this 

ihhcHts -fcoo. ^ 


s the same (S-tihgPatv-ol 

bu*t how i 七 ihlicv^i'ts *(Vo» 
the |l/Vo\rkc\r ihtc\r-PoldC. It looks 
like a tihy bu-t \i mdkes a 

ih a^y dass that 
irwflcrwCh-ts (S-tih^Patv-ol. 


(interface) 

IWorker 


Job 

ShiftsLeft 


DoThisJob() 

WorkOneShiftf) 
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Icanhascheezburger 


The RoboPee 4000 can do a worker bee's job 
without using valuable honey 


Let’s create a new bee, a RoboBee 4000, that runs on gas. We can 
have it inherit from the I Worker interface, though, so it can do 
everything a normal worker bee can. 


class Robot 


{ 


} 


~ -f^\s \s ouv bas'^ Robot 
dass, so robots 6a, 
ot\ ^asol'mc- 


RoboBee 


ShiftsToWork 

ShiftsWorked 

ShiftsLeft 

Job 


DoThisJob() 



public void ConsumeGas() { 


參 • • 


class RoboBee : Robot, IWorker 

{ 



The RoboBee dass 
ihhev-i-ts -Pvom Robot dhd 
i^plcmch-ts \)NoYVt>r. That 
its a V-obot, but 
do the job o( a wovkev 

.Rcv-fc( 


bcc. 





TV^c Robo^cc tlass 

ctV^ods 伤 c 
IWovkcv mtcv^a^c- 


} 


private int ShiftsToWork; 
private int shiftsWorked; 
public int ShiftsLeft 

{get {return ShiftsToWork - shiftsWorked;}} 
public string Job { get; private set; } 
public bool DoThisJob(string job, int ShiftsToWork){ 
public void WorkOneShift() {...} 

RoboBee 卜如 W— 

toAt v/ould 於七 


Remember, for other classes in the application, there’s no 
functional difference between a RoboBee and a normal worker 
bee. They both implement the interface, so both act like worker 
bees as far as the rest of the program is concerned. 

But, you could distinguish between the types by using: 

Wc see Y/ha 七 da ss 

ov *m-tcv*fatc Y/ov-kcv-Bcc 



if (workerBee is Robot) { 
// now we know workerBee 
// is a Robot object 


subclasses ov- 


u. 




Any class can implement 
ANY interface as long 
as it keeps tke promise 
ol implementing tke 
interface’s metkocts and 
properties. 
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interfaces and abstract classes 


Is tells you what aw object implgmcwts; 
as tells the compiler how totreat your object 


Sometimes you need to call a method that an object gets from an interface it 
implements. But what if you don’t know if that object is the right type? You 
use is to find that out. Then, you can use as to treat that object — which 
you now know is the right type — as having the method you need to call. 


IWorker[] 
bees[0]= 
bees[1]= 
bees [2]= 


bees = new IWorker[3] 
new NectarStinger(); 
new RoboBee(); 
new Worker(); 



^11 ihese bees 




we doh^i k 


IlYoirk 

how whidl ohes 




for (int i = 
if (bees [ 

*to 


o >： 


see i-p i"t ir^plxivts 

IHctiavCoWc^ior. 


i < bees.Length; i++) 
is INectarCollector) { 
INectarCollector thisCollector 
thisCollector 


Wc ^all 

I hi cdtavCol I cd-fcov- methods 
ov\ the bees. ThcyVc o-P 
■type llVovkcv, a^d doY^i 
about l/VcdtavCollcd-tov 
wthods. 




bees [i] (Mls) INectarCollector 

^ - 


thisCollector.GatherNectar() 


■to 


• • • 


c^terpen your pencil 


We ^ "as ^ s f/- 

f treat A 

MW v/c tav^ ta\\ 1/Vc^CollcdU w 栎 odk 孙 i° ^ ^ 


Take a look at the array on the left. For each of these statements, 
write down which values of i would make it evaluate to true. 
Also, two of them won’t compile — cross those lines out. 


IWorker[] 
Bees [ 0] — 
Bees [ 1]= 
Bees [ 2] — 
Bees [ 3] — 
Bees [ 4] — 
Bees [ 5] — 
Bees [ 6] — 
Bees [ 7]= 


Bees = new IWorker[8]; 
new NectarStinger(); 
new RoboBee(); 
new Worker(); 

Bees [0] as IWorker; 
IStingPatrol; 
null; 

Bees [ 0]; 

new INectarCollector () 


1. (Bees[i] is INectarCollector) 


2. (Bees[i] is IStingPatrol) 


3. (Bees [i] is IWorker) 
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it looks like one thing，but it’s really another! 


A CoffccMakcr is also m Appliance 

If you’re trying to figure out how to cut down your energy bill each month, you 
don’t really care what each of your appliances does. You only really care that they 
consume power. So if you were writing a program to monitor your electricity 
consumption, you’d probably just write an Appliance class. But if you needed 
to be able to distinguish a coffee maker from an oven, you’d have to build a class 
hierarchy. So you’d add the methods and properties that are specific to a coffee 
maker or oven to some Cof f eeMaker and Oven classes, and they’d inherit from 
an Appliance class that has their common methods and properties. 


public void MonitorPower( Appli ance appliance) { 

// code to add data to a household Wtrts a method 
// power consumption database (V m 七 ^ 


This todt would affcav- latcv- oy\ m the 
-to mo^rtov makers 

pov/CV* do^sumptio^. 

CoffeeMaker misterCoffee = 
MonitorPower(misterCoffee) 



^ — 祕 rtor 如 \>oy/cv* 

+ov- d 

Kousc- 



CoffeeMaker 


Oven 

CoffeeLeft 


Capacity 

FillWithWaterf) 


Preheat() 

MakeCoffee() 


HeatUp() 



Reheat() 


new CoffeeMaker() 


cf^harpen your pencil 

Solution 


though the /Wohi-tov-Powc\rO method takes 
a -to ah Appliahdc object you 

P as ^ '"t ^istc\rCoHcc \rc-Pcv-chdc bemuse 
Co-Pfcc/Wakc\r is a subclass o( Afflia^c. 


Vo\a already saw this 
the last dhaptev-, 
when you how 
you dould pdss a 
BLT \TC-Pcv-ChdC -to 

3i method that 

a Sdhdwi^h. 


Take a look at the array on the left. For each of these statements, 
write down which values of i would make it evaluate to true. 
Also, two of them won’t compile — cross them out. 


工 Worker[] Bees = new IWorker[8]; 


Bees[0] 
Bees[1] 
Bees[2] 
Bees[3] 

i -3 

Bees[5] 
Bees[6] 


new NectarStinger(); 
new RoboBee(); 
new Worker(); 

Bees[0] as IWorker; 
■ acting: 



(Bees[i] is INectarCollector) 


••… »..叫公 . 

iruplcruch-ts the 

IStmapa^ol ^ (Bees[i] is 工 StingPatrol) 

ih-tcv-ta^c- v 

O, Z, a^d 




null; 

Bees[0]; 

— r c q ~1 1 o c q r -- 


3. (Bees [i] is 工 Worker) 


O, I, 2- } 1>, 
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interfaces and abstract classes 


Upcasting works with both objects and interfaces 

When you substitute a subclass for a base class — like substituting a coffee maker for an 
appliance, or a BLT for a sandwich — it’s called upcasting. It’s a really powerful tool 
that you get when you build class hierarchies. The only drawback to upcasting is that 
you can only use the properties and methods of the base class. In other words, when you 
treat a coffee maker like an appliance, you can’t tell it to make coffee or fill it with water. 

But you can tell whether or not it’s plugged in, since that’s something you can do with 
any appliance (which is why the Pluggedln property is part of the Appliance class). 


O Levs CRBATB S^>Me ^BJBCTS^ 

We can create a Cof feeMaker and Oven class as usual: 

CoffeeMaker misterCoffee = new CoffeeMaker(); 

Oven oldToasty = new Oven(); 


lAfe’ll s*tav*t by 

^y\ 0 ^/tY\ object and a 

Co-f-PccMakcv object 3s usual- 




MHAT IF W/B W/ANT T^> CRBATB AM ARRAY OF APPLIANCES? 

You can’t put a Cof f eeMaker in an Oven [ ] array, and you can’t put an Oven in a 
Cof f eeMaker [ ] array. But you can put both of them in an Appliance [ ] array: 


Appliance[] kitchenWare = new Appliance[2]; 


kitchenWare[0] 
kitchenWare[1] 


misterCoffee; 
oldToasty; 


巧總 ㉟ 



BUT YOU CAH f T mBAT ANYAPPUAhJCB UKB AM 

When you’ve got an Appliance reference, you can only access the methods and properties 
that have to do with appliances. You can’t use the Cof f eeMaker methods and properties 
through the Appliance reference even if you know it’s really a CoffeeMaker. So these 
statements will work just fine, because they treat a Cof f eeMaker object like an Appliance: 


poy/c\rCohSurwcv- 
is Apfliahdc 


Appliance powerConsumer = new CoffeeMaker(); 

powerConsumer.ConsumePower(); 丁 his lihe wok /七 Compile bemuse 

powcvCohSumcv is ay\ Applia^c 

But as soon as you try to use it like a Cof f eeMaker:so i-t ohly be used 

powerConsumer . MakeCof fee () ; - ^ "to do Appli^hdc "things. 


your code won’t compile, and the IDE will display an error: 




' Appliance 1 does not contain a 
definition for 'MakeCoffee' 


poihtmg -to a 
Co-Pfcc/Wakcv- 



because once you upcast from a subclass to a base class, then you can only access the 
methods and properties that match the reference that you’re using to access the object. 


you are here ► 


309 







PowHcastmg lets you turw your 
appliance back into a coffee maker 

Upcasting is a great tool, because it lets you use a coffee maker or an oven 
anywhere you just need an appliance. But it’s got a big drawback — if you’re 
using an Appliance reference that points to a Cof feeMaker object, you 
can only use the methods and properties that belong to Appliance. And that’s 
where downcasting comes in: that’s how you take your previously upcast 
reference and change it back. You can figure out if your Appliance is really a 
Cof feeMaker using the is keyword. And once you know that, you can convert 
the Appliance back to a Cof feeMaker using the as keyword. 


Wtyts ouv 

{jo a C^ccMakcv- 

objct*t -fv-om last 


o 


© 


Well start with the Cof feeMaker we already upcast. 

Here’s the code that we used: 

Appliance powerConsumer = new CoffeeMaker(); 
powerConsumer.ConsumePower(); 

But what if we want to turn the Appliance back into a Cof feeMaker? 

The first step in downcasting is using the is keyword to check if it’s even an option. 

if (powerConsumer is CoffeeMaker) 

// then we can downcast! 



❹ 


^^3 


I J 

The java Joe \rc-fc\rchdc 

foihts -to the 

Co^fccMakcv- 

as 

pov/cv-CohSurncv-. But 
a CoPfccMakcv- 


s 


Now that we know it’s a Cof feeMaker, let’s use it like one. 

The is keyword is the first step. Once you know that you’ve got an Appliance reference so i-t 

that’s pointing to a Cof feeMaker object, you can use as to downcast it. And that lets you 乙 all the AlakcCo-PfccO 
use the Cof feeMaker class’s methods and properties. And since Cof feeMaker inherits r^thod. 
from Appliance, it still has its Appliance methods and properties. 


if (powerConsumer is CoffeeMaker) { 

CoffeeMaker javaJoe = powerConsumer as CoffeeMaker; 
javaJoe.MakeCoffee (); 


Whew downcasting fails, as returns null 

So what happens if you try to use as to convert an Oven object into a 
Cof feeMaker? It returns null — and if you try to use it, .NET will cause 
your program to break. Uh oh, -these 

if (powerConsumer is Cof feeMaker) { /do 灼七 




C °^eeMa^ 


I 



Oven foodWarmer = powerConsumer as Oven; 
foodWarmer.Preheat () 


fowc\rCo>r>suirwcv is HOT ay\ 0\/CY\ object So 
you bry io do^uasi ii v/i-th W', the 
(oodWartmtr Cv\ds uf sci -to m\l 

>n\\cy\ you "bry "to use a null 
"this happens v/hcK> you \ruh -the … 


An unhandled exception of typ e 'System.NullReferenceE^ception 1 occurred in 
UpcastingDowncastingExample.exe 
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Upcasting and dowwcastiwg work with interfaces, too 

You already know that is and as work with interfaces. Well, so do all of the upcasting 
and downcasting tricks. Let’s add an I Cooks Food interface for any class that can heat 
up food. And we’ll add a Microwave class — both Microwave and Oven implement 
the I Cooks Food interface. Now there are three different ways that you can access an 
Oven object. And the IDE’s IntelliSense can help you figure out exactly what you can 
and can’t do with each of them: 


Oven misterToasty 
misterToasty. 


Capacity 


new Oven() 


/\S SOOY\ dS you 

type 七 he dot, 
|r\*bciriScir\sc 
y/'mdow will fof 
up y/rth a lis 七 
o-f all 

mcmbcvs you CBv\ 
use- 



int Oven, Capacity 


(interface) 

ICooksFood 


Capacity 


HeatUp() 

Reheat() 


/Wy tlass 七 ha 七 

ICooksFood »S 

■bV^a*b V^ca-t 

uf -food- 



Color 
♦ ConsumePower 

• Equals 
GetHashCode 
GetType 

^ HeatJUp 
Pluggedln 

• Preheat 
Reheat 




Ovch ob'vcdt, so 


the r 


>3s-ty i ： 
poihtihg -to av\ 

it “h atuss all o( the methods 
3hd p\ropc\r-tics...but its the least 

9 «^c\ral type, so you Uh ohly 
poiht it ai Ovch objects. 



Oven 


Microwave 

Capacity 


Capacity 

Preheat)) 


HeatUp() 

HeatUp() 


Reheatf) 

Reheat() 


MakePopcomQ 


ICooksFood cooker; 
if (misterToasty is ICooksFood) 

cooker = misterToasty as ICooksFood; 
cooker. 


Capacity 1 


卜 Equals 
GetHashCode 
卜 GetType 
HeatUp 
v Reheat 
ToSlj'ing 


int ICooksFood. Capacity 


dooke\r is ^y\ ICooksFood rt(tvtY\tc 

-to that same 0 ^/tr\ objedt |*t 
tBv\ O^ly BCCtss ICooksFood members ， 
bu 七••七 tBr\ also *to a Mi^vowavc 
object 


Appliance powerConsumer; 
if (misterToasty is Appliance) 

powerConsumer = misterToasty; 


powerConsumer. 

poy/c\rCo^sumcv- is 
Afplia^C VC-fc\rC^dC. |*t 
ov\\y lets you yt *to 
fublid -fields, methods, d^d 

pcvtics *m Applia 灼 de. 

also pom 七 i*t at 
a CoffccMakcv- object i*f 
you 


p\ro' 

You 


Color 


ConsumePower 
_ Equals 
GetHashCode 
:-令 GetType 

"Pluggedln 
ToString 


Color Appliance.Color 


Tkree ctillerent 
relerences tkat 
point to tke same 
otject can access 
ctiHerent metkocts 
and properties, 
ctepencting on tke 
relerence^s type. 


you are here 
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no dumb questions 



Dumb Quest! 


ons 


So back up—you told me that I 
can always upcast but I can’t always 
downcast. Why? 

A. 

Because the compiler can warn you 
if your upcast is wrong. The only time an 
upcast won’t work is if you’re trying to set an 
object equal to a class that it doesn’t inherit 
from or an interface that it doesn’t implement 
And the compiler can figure out immediately 
that you didn’t upcast properly, and will give 
you an error. 

On the other hand, the compiler doesn’t 
know how to check if you’re downcasting 
from an object or interface reference to a 
reference that’s not valid. That’s because it’s 
perfectly legal to put any class or interface 
name on the righthand side of the as 
keyword. If the downcast is illegal, then the 
as statement will just return null. And 
it’s a good thing that the compiler doesn’t 
stop you from doing that, because there are 
plenty of times when you'd want to do it. 

Someone told me that an interface 
is like a contract, but I don’t really get 
why. What does that mean? 

Yes, we’ve heard that too—a lot 
of people like to say that an interface is 
like a contract. (That’s a really common 
question on job interviews.) And it’s true, to 
some extent. When you make your class 
implement an interface, you’re telling the 
compiler that you promise to put certain 
methods into it. The compiler will hold you to 
that promise. 

But we think that it’s easier to remember 
how interfaces work if you think of an 
interface as a kind of checklist. The compiler 
runs through the checklist to make sure that 
you actually put all of the methods from the 
interface into your class. If you didn’t, it’ll 
bomb out and not let you compile. 


What if I want to put a method body 
into my interface? Is that OK? 


A: No, the compiler won’t let you do that. An 
interface isn’t allowed to have any statements 
in it at all. Even though you use the colon 
operator to implement an interface, it's not 
the same thing as inheriting from a class. 
Implementing an interface doesn’t add any 
behavior to your class at all, or make any 
changes to it. All it does is tell the compiler 
to make sure that your class has all of the 
methods that the interface says it should have. 


Then why would I want to use an 
interface? It seems like it’s just adding 
restrictions, without actually changing 
my class at all. 

Because when your class implements 
an interface, then an interface reference can 
point to any instance of that class. And that’s 
really useful to you—it lets you create one 
reference type that can work with a whole 
bunch of different kinds of objects. 


Here’s a quick example. A horse, an ox, a 
mule, and a steer can all pull a cart. But in 
our zoo simulator, Horse, Ox, Mule, 
and Steer would all be different classes. 
Let’s say you had a cart-pulling ride in your 
zoo, and you wanted to create an array of 
any animal that could pull carts around. Uh- 
oh—you can’t just create an array that will 
hold all of those. If they all inherited from the 
same base class, then you could create an 
array of those. But it turns out that they don’t. 
So what’ll you do? 

That’s where interfaces come in handy. You 
can create an I Puller interface that has 
methods for pulling carts around. Now you 
could declare your array like this: 


工 Puller[] pullerArray; 


Now you can put a reference to any 
animal you want in that array, as long as it 
implements the I Puller interface. 

Is there an easier way to implement 
interfaces? It’s a lot of typing! 

Why, yes, there is! The IDE gives you 
a very powerful shortcut that automatically 
implements an interface for you. Just start 
typing your class: 

class 

Microwave : ICooksFood 


Click on ICooksFood— you'll see a 
small bar appear underneath the T. Hover over 
it and you’ll see an icon appear underneath it: 

interface ICooksFood 

ICooksFood 

省 Sometimes its hav-d *to dlidk 

oy\ the but Ctv-l-fCV-iod 
will v/o\rk, "too. 

Click on the icon and choose "Implement 
Interface ‘ICooksFood”’ from the menu. It'll 
automatically add any members that you 
haven’t implemented yet. Each one has a 
single throw statement in it—they’ll cause 
your program to halt, as a reminder in case 
you forget to implement one of them. (You’ll 
learn about throw in Chapter 10.) 

An interface is like 
a ckecklist tkat tke 
compiler runs tkrougfli 
to make sure your 
class implementect a 
certain set oi metkocts. 
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interfaces and abstract classes 



Extend the iciown interface and use classes that implement it by 
adding more code to the Console application you created earlier. 



Start with the 工 Cl own interface from the last u Do thtsF , on page 300: 


ICIown 

(interface) 

FunnyThinglHave 


HonkQ 


❺ 

❺ 


interface 工 Clown { 

string FunnyThinglHave { get; } 

void Honk(); 

} 

Extend 工 Clown by creating a new interface, 工 ScaryClown ， that 
inherits from I Clown. It should have an additional string 
property called ScaryThinglHave with a get accessor but no set 
accessor, and a void method called ScareLittleChildren (). 

Create these classes: 

* A funny clown class called FunnyFunny that uses a private string 
variable to store a funny thing. Use a constructor that takes a 
parameter called f unnyThinglHave and uses it to set the private 
field. The Honk () method should print: “Hi kids! I have a ” followed 
by the funny thing it has. The FunnyThinglHave get accessor 
should return the same thing. 


53 

♦♦ 

FunnvFunnv 


IScaryClown 

FunnyThinglHave 


(interface) 



ScaryThinglHave 

Honk() 


ScareLittleChildrenf) 



ScareLittleChildren() 


* A scary clown class called ScaryScary that uses a private variable to 
store an integer that was passed to it by its constructor in a parameter 
called numberOf ScaryThings. The ScaryThinglHave get 
accessor should return a string consisting of the number from the 
constructor followed by “spiders”. The ScareLittleChildren () 
prints a message that says, “Boo! Gotcha!” 



Here’s new code for the Main () mtehod — but it’s not working. Gan you figure out how to fix it? 


static void Main(string[] args) { 

ScaryScary fingersTheClown = new ScaryScary("big shoes M , 14); 
FunnyFunny someFunnyClown = fingersTheClown; 

工 ScaryClown someOtherScaryClown = someFunnyClown; 


someOtherScaryClown.Honk() 
Console.ReadKey(); 


fmyvs Clo 娜 ， s 從 7. 




you are here ► 
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no no! nooo! noo! no more scary clowns! 



Extend the iciown interface and use classes that implement it. 

oPLpixOH 

interface 工 Clown { 

string FunnyThinglHave { get; } 
void Honk(); 

} 

interface 工 ScaryClown : 工 Clown { 

string ScaryThinglHave { get; } 
void ScareLittleChildren(); 

} 

class FunnyFunny : 工 Clown { 

public FunnyFunny(string funnyThinglHave) { 

this•funnyThinglHave = funnyThinglHave; 


private string funnyThinglHave; 
public string FunnyThinglHave { 

get { return "Hi kids ! 工 have 


TKc ttohkO 
mC*tKod jus 七 uses 
七 his addessov 
*to display *iis 

message— Y\ttA 

have same 
./ todt 

+ funnyThinglHave; } 


You dould have 
implerwerrted the 
|Cloy/r> rwethod a^d 
piropeviy aga’m, but 
why hot jus-t mhevi-t 
-rv-orw PiAirmyPurmy? 


V 


public void Honk() { 

Console.WriteLine(this.FunnyThinglHave); 

} Sda\rySda\ry is d subdbss of PurmypuKmy 扣 d Pu^mypurmy 

广 i^pIcrwCh-b ICIoy/^ SdairySdairy implements ICloym -boo. 


class ScaryScary : \^unnyFunn^) 工 ScaryClown 

public ScaryScary(string funnyThinglHave, int numberOfScaryThings) 
: base(funnyThinglHave) { 

this.numberOfScaryThings 二 numberOfScaryThings; 

} 


private int numberOfScaryThings; 
public string ScaryThinglHave { 

get { return ，，工 have " + numberOf ScaryThings 


spiders 


public void ScareLittleChildren() { 

Console.WriteLine("Boo! Gotcha! 


You dah set a FuhhyFuh^y cq ua | 

“ object because SwySwy 

j FuhhyFuhhy. But you sci 
^v-yClowh v-c+cv-chdc 


static void Main(string[] args) 
ScaryScary fingersTheClown 
FunnyFunny someFunnyClown 二 
工 ScaryClown someOtherScaryClown 


io a £( 

ihhev-rts 

以扣 y CI 。，to jus 七 ahy dowh, 
bemuse you do,-tk,ow i^ that doJ\s 

{ hats why you heed h> use the as key 赠 d. 7 

new ScaryScary("big shoes", 14) 
fingersTheClown; 

someFunnyClown as ScaryScary; 



someOtherScaryClown.Honk(); 

Console . ReadKey () ; 3 lso use *tKc sow\cO"tKcv*Sd 3 vyClo>Mi^ *to ddll 

S 乙 av^LittleChildv^O — bu*t you jet *to i*t -from -the 

somcFu^^yClov/^ \rc-Pcv-c^dc. 
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There's more thaw just public awd private 

You already know how important the private keyword is, how you use it, and 
how it’s different from public. G# has a name for these keywords: they’re 
called access modifiers. The name makes sense, because when you change ^ 
an access modifier on a property, field, or method of a class — its members — or 
the entire class, you change the way other classes can access it. There are a few 
more access modifiers that you’ll use, but we’ll start with the ones you know: 


^ a dasss methods, 

士 ields, pvopcirtics i-fcs 

啪 embers. 啪 embev" 乙 ah be 

•dirked with -the publid or 
autss 



lo^ as -they tar\ atetss -the dcdlav-'mj dlass) 

public means that anyone can access it. 

When you mark a class or class member public, you’re telling G# that any instance of any 
other class can access it. It’s the least restrictive access modifier. And you’ve already seen how 
it can get you in trouble — only mark class members public if you have a reason. That’s how 
you make sure your classes are well encapsulated. 


o 

o 

o 


private means that only other members can access it. 

When you mark a class member private, then it can only be accessed from other members 
inside that class or other instances of that class. You can’t mark a class private- 
unless that class lives inside another class, in which case it’s only available to instances ^ 
of its container class. Then it’s private by default, and if you want it to be public you need to 
mark it public. 


l-f you leave 

modi-f iev- 


v/hc 的 you 

d c\Bss member, i*t 
dc-faults *bo p\riva*tc- 


protected means public to subclasses, private to everyone else. 

You’ve already seen how a subclass can’t access the private fields in its base class — it has 
to use the base keyword to get to the public members of the base object. Wouldn’t it 
be convenient if the subclass could access those private fields? That’s why you have the 
protected access modifier. Any class member marked protected can be accessed by 
any other member of its class, and any member of a subclass of its class. 


|*f you leave off *thc addess 
modi-f iev v/hc 灼 you deddvr 

a dlass or by\ m-tev-fade, 


by default i*ts sc*t *to 
•nrrtm^al. /W s just 
-f mc -for most dlasscs—i*t 


medirtS -that ainy othev- dldss 


internal means public only to other classes in an assembly. 

The built-in .NET Framework classes and all of the code in your projects are in 
assemblies — libraries of classes that are in your project’s list of references. You can see a 
list of assemblies by right-clicking on References in the Solution Explorer and choosing “Add 
Reference...” 一 when you create a new Windows Forms application, the IDE automatically 
includes the references you need to build a Windows application. When you build an assembly, 
you can use the internal keyword to keep classes private to that assembly, so you can only 
expose the classes you want. You can combine this with protected — anything you mark 
protected internal can only be accessed from within the assembly or from a subclass. 


•m *thc assembly dd)rt \rcad it 
l-f youVc rnyt usmj multiple 
assemblies, *m-tc\nr»al will 
y/ork just ds >Mell ds publid 
-for classes mtcv-fadcs. 
^ivc i*t a sho*t—Jo *bo By\ 
old project some 

ox *thc dlasscs *bo 
By\d see what happens. 


o sealed says that this class can’t be subclassed. 

There are some classes that you just can’t inherit from. A lot of the .NET Framework classes 
are like this — go ahead, try to make a class that inherits from String (that’s the class whose 
IsEmptyOrNull () method you used in the last chapter). What happens? The compiler 
won’t let you build your code — it gives you the error “cannot derive from sealed type ‘string’’’. 

You can do that with your own classes — just add sealed after the access modifier. 

、 _^ a 攸说 d. 

There’s a little more to all of these definitions. Take a peek at D are here y 3^5 

leftover #3 in the appendix to learn more about them. 


於 attess 










Access modifiers change visibility 

Let’s take a closer look at the access modifers and how they affect the scope of the 
various class members. We made two changes: the funnyThinglHave backing 
field is now protected, and we changed the ScareLittleChildren () 
method so that it uses the funnyThinglHave field: 


々 lake -these -two -to 

youir 0 ym exc^isc solutioh. 
Tkh -the y^roi^ied 

此匕 modi-fieir ba^k io 
3hd sec what cv-iroirs you get. 




Here are two interfaces. I Cl own defines a clown who honks his 
horn and has a funny thing. IScaryClown inherits from clown. A 
scary clown does everything a clown does, plus he has a scary thing 
and scares little children. (These haven’t changed from earlier.) 

interface IClown { 

string FunnyThinglHave { get; } 
void Honk(); 

} 

interface IScaryClown : IClown { 

string ScaryThinglHave { get; } 
void ScareLittleChildren(); 


TKc w *this” keywovd also dKar>^cs variable 
youVc *to- l*t says *to , 'Look 

a 七七 he duvvcjr>*t *ms*tay>dc of dlass *to md 
y/V>a*tcvc\r tor\r\tt\xA *to—CVCir> i-f 
maidkes a pavamc*tcv ov lodal variable. 


This is a vcally 匕。_ 。灼 >way *to 
use smdc 

av\d badkm^ -f ield Kavc *tV>c same 

v-c-fcv-s 

-fco *tKc fav-amc*tcv-, >wK*ilc *tK*is. 

-fu^yThmglttavc is i\\t badkm^ -f ield- 



The FunnyFunny class implements the 工 Clown interface. We made the funnyThinglHave 
field protected so that it can be accessed by any instance of a subclass of FunnyFunny. 


By dddihj 
“this", we "fcold 
C 养 that wcVc 
talkihg about 
the ba^kih^ 
*Pidd, hot the 
pa\rarwc-tc\r that 
has the same 



class FunnyFunny : IClown { 

public FunnyFunny(string funnyThinglHave) { 

this . funnyThinglHave = funnyThinglHave; 

} Wis FuhhyThihglHolvc 

protected string funnyThinglHave; ^ 

public string FunnyThinglHave { ^cUii\cCMd^O method 

get { return n Hi kids! I have n + funnyThinglHave; } 

} 


public void Honk() { 

Console.WriteLine(this.FunnyThinglHave); 




i/Vh ⑶ you use W\i\\ a p\ropc\rty, i*t 

•tells C# bo c%cdu*tc i\\t sti or 
adtessov. 
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o 


Access 



is private, whi 乙 h is 

typical o( a 
-ricld. So ohly ^ho-thev- 
ihs^hde of Sda\rySdav"y 
would be able io see ii 

J 


The ScaryScary class implements the IScaryClown 
interface. It also inherits from FunnyFunny, and since 
FunnyFunny implements 工 Clown, that means ScaryScary 
does, too. Take a look at how the ScareLittleChildren () 
method accesses the funny Thing I Have backing field — it can 
do that because we used the protected access modifier. If we’d 
made it private instead, then this code wouldn’t compile. 

class ScaryScary : FunnyFunny, IScaryClown { 
public ScaryScary(string funnyThinglHave, 

int numberOfScaryThings) 

: base(funnyThinglHave) { 

this.numberOfScaryThings = numberOfScaryThings;^ 

} 

private int numberOfScaryThings; 

public string ScaryThinglHave { 

get { return n I have n + numberOfScaryThings + n spiders n ; 

} The keyword 

"tells C^* "to some 七 hi hg 

public void ScareLittleChildren () { -to cvcv-yohc 

Console .WriteLine ("You can f t have my ▼▼ a su ^l ass * 

+ base.funnyThinglHave); J, 

} kcy T d L tdls C * ^ ^ K K a I 说 LyTHU 

} iV U Al : Bui ^^ this would ^ause the 。 —1 饮 I — 

Ca ^ t- S ° ±^ ，S ，h ^ ，S ^ 3SC， Y ou C\r\ro\r. But whch wc dhdhaed 

〜you + ， 9 u，e out why? it .ade it visible 

■to 如 y subclass o( PiAKmypuKmy. 

o Here’s a Main () method that instantiates FunnyFunny and ScaryScary. Take a look at how it uses as 
to downcast someFunnyClown to an IScaryClown reference. 

static void Main(string[] args) { 

ScaryScary fingersTheClown = new ScaryScary( n big shoes", 14); 
FunnyFunny someFunnyClown = fingersTheClown; 

IScaryClown someOtherScaryClown = someFunnyC1own as ScaryScary; 

C someOtherScaryClown. Honk (); 

Console ReadKey () ； ^ pu*t m some s-teps -to show you you dould 


S'mtc MamO 
mC*t^od isr/ 七 fav 七 

o( Fur^ir>YFuir>ir>y oV 

SdavySdavy, *i*t 
addess pvo*tcd*tcd 
•furmyTIVmg Have -f ield- 


updas-t £dav-yS^av-y -to Fu^^yFu^^y, a 灼 d dov/^as-t 

•that "to |£^a\ryClow^. Bu*t all *thv-cc o( -those Tmcs ^ould 
be Collapsed nrfco a single Imc- Csr^ you -Pijuvc ou*t hoy/? 




\{!s outside o( bo*tK dlasscs, so statem ⑼ *b 
mside \i oy>ly Kavc autss bo *tKc fubk members 
of a” Fur^>yFuirM^Y ov Sdav-ySdav-y objc£.*ts* 


you are here ► 
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eww, duplicate code! 


Why would I want to use an 
interface instead of just writing all of the 
methods I need directly into my class? 

A! You might end up with a lot of different 
classes as you write more and more 
complex programs. Interfaces let you group 
those classes by the kind of work they do. 
They help you be sure that every class that’s 
going to do a certain kind of work does it 
using the same methods. The class can do 
the work however it needs to, and because 
of the interface, you don’t need to worry 
about how it does it to get the job done. 

Here's an example: you can have a Truck 
class and a Sailboat class that 
implement 工 CarryPassenger. Say 
the I Carry Passenger interface 
stipulates that any class that implements 
it has to have a ConsumeEnergy () 
method. Your program could use 
them both to carry passengers even 
though the Sailboat class’s 
ConsumeEnergy () method uses wind 
power and the Truck class’s method uses 
diesel fuel. 

Imagine if you didn’t have the 
工 CarryPassenger interface. Then it 
would be tough to tell your program which 
vehicles could carry people and which 
couldn't. You would have to look through 
each class that your program might use 
and figure out whether or not there was a 
method for carrying people from one place to 
another. Then you’d have to call each of the 
vehicles your program was going to use with 
whatever method was defined for carrying 
passengers. And since there's no standard 
interface, they could be named all sorts of 
things or buried inside other methods. You 
can see how that’ll get confusing pretty fast. 


tJiereiare no o 

Dumb Questi9ns 


. Why do I need to use a property? 
Can’t I just include a field? 

Good question. An interface only defines 
the way a class should do a specific kind of job. 
It’s not an object by itself, so you can’t instantiate 
it and it can’t store information. If you added a 
field that was just a variable declaration, then C# 
would have to store that data somewhere—and 
an interface can’t store data by itself. A property 
is a way to make something that looks like a field 
to other objects, but since it’s really a method, it 
doesn’t actually store any data. 

What’s the difference between a 
regular object reference and an interface 
reference? 

You already know how a regular, 
everyday object reference works. If you 
create an instance of Skateboard 
called vertBoard, and then a new 
reference to it called halfPipeBoard, 
they both point to the same thing. But if 
Skateboard implements the interface 
I Street Tricks and you create an 
interface reference to Skateboard called 
streetBoard, it will only know the 
methods in the Skateboard class that are 
also in the IStreetTricks interface. 


All three references are actually pointing to the 
same object. If you call the object using the 
half PipeBoard or vertBoard 
references, you’ll be able to access any 
method or property in the object. If you call 
it using the streetBoard reference, 
you’ll only have access to the methods and 
properties in the interface. 


Then why would I ever want to use 
an interface reference, if it limits what I 
can do with the object? 


A! Interface references give you a way 
of working with a bunch of different kinds 
of objects that do the same thing. You 
can create an array using the interface 
reference type that will let you pass 
information to and from the methods in 
工 CarryPassenger whether you’re 
working with a truck object, a horse 
object, a unicycle object, or a car 
object. The way each of those objects does 
the job is probably a little different, but with 
interface references, you know that they all 
have the same methods that take the same 
parameters and have the same return types. 
So, you can call them and pass information 
to them in exactly the same way. 

Why would I make something 
protected instead of private or public? 

Because it helps you encapsulate your 
classes better. There are a lot of times that a 
subclass needs access to some internal part 
of its base class. For example, if you need 
to override a property, it’s pretty common to 
use the backing field in the base class in the 
get accessor, so that it returns some sort of 
variation of it. But when you build classes, 
you should only make something public 
if you have a reason to do it. Using the 
protected access modifier lets you expose it 
only to the subclass that needs it, and keep 
it private from everyone else. 


Interface references 
only know atout 
tke metkocts and 
properties tkat 
are deiinect in tke 
interface. 
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interfaces and abstract classes 


Some classes should never be mstantiated 

Remember our zoo simulator class hierarchy? You’ll definitely end up 
instantiating a bunch of hippos, dogs, and lions. But what about the 
Canine and Feline classes? How about the Animal class? It turns out 
that there are some classes that just don’t need to be instantiated.. .and, in 
fact, don’t make any sense if they are. Here’s an example. 

Let’s start with a basic class for a student shopping at the student bookstore. 

class Shopper { 

public void ShopTillYouDrop() { 

while (TotalSpent < CreditLimit) 

BuyFavoriteStuff(); 

} 

public virtual void BuyFavoriteStuff () { 

//No implementation here - we don't know 
// what our student likes to buy! 

} 

} 

Here’s the ArtStudent class — it subclasses Shopper: 
class ArtStudent : Shopper { 


Shopper 

TotalSpent 

CreditLimit 


ShopTillYouDrop() 

BuyFavoriteStuff() 


/\ 

~! 7 ^ • 


ArtStudent 


Engineering 



Student 




BuyFavoriteStuff() 


BuyFavoriteStuff() 


The /1\rt^tudCht ahd 



EhgihCC\rihgS-tudch-t 
^Idsscs ovcv*\ridc 
the BuyFavov-i-tcS-tu-f^O 

method, but they buy 

wy di-PWh-t iWms. 


public override void BuyFavoriteStuff () { 

BuyArtSupplies(); 


BuyBlackTurtlenecks(); 
BuyDepressingMusic(); 


And the EngineeringStudent class also inherits from Shopper: 


class EngineeringStudent : Shopper { 

public override void BuyFavoriteStuff () { 

BuyPencils(); 

BuyGraphingCalculator(); 
BuyPocketProtector(); 


So what happens when you instantiate Shopper? Does it ever make sense to do it? 


you are here ► 
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I can’t believe it’s not an interface! 


Aw abstract class is like a cross 
between a class and an interface 


Suppose you need something like an interface, that requires classes to 
implement certain methods and properties. But you need to include some 
code in that interface, so that certain methods don’t have to be implemented 
in each inheriting class. What you want is an abstract class. You get the 
features of an interface, but you can write code in it like a normal class. 

O ABSTRACT 6UASS IS UIK5 A 
6UASS. 

You define an abstract class just like a normal one. It has fields and 
methods, and you can inherit from other classes, too, exactly like with 
a normal class. There’s almost nothing new to learn here, because 
you already know everything that an abstract class does! 


O AN ABSTRACT 6UASS IS UIK5 AN INT612FA65. 

When you create a class that implements an interface, you agree to 
implement all of the properties and methods defined in that interface. 
An abstract class works the same way — it can include declarations 
of properties and methods that, just like in an interface, must be 
implemented by inheriting classes. 


A method that has a deda^aho^ but 
ho statcmch-b o\r method body is 

d f llcd method. IhkeHima 

州⑽士 all abs-tv-a^t 

just like whch they mhev-i-t 

Wom ah ih-tcir-fadc. 


0hl y Masses dah have 

methods, l-f you pu-t ah abstv-adt 
method a dass, you II have 
wirk that dass abs-tira^ ov- i-t woh'-t 

c . Icav-h mov-c about how -to 
W\rl< a dass abs-t\rad-t ih a mihu-te. 





BUT AN ABSTRACT CLASS CfK^l B5 
INSTANTIATED. 

The biggest difference between an abstract class and a concrete 
class is that you can’t use new to create an instance of an abstract 
class. If you do, G# will give you an error when you try to compile 
your code. 


Q 


Cannot create an instance of the 
abstract class or interface *MyClass' 


"Uc opposite of akstratt 
is A tor\Cct\,t 

r^t£\\od »s oy\c V>as a 
body ， 扣 d all classes 
you've With so 

av-c Cor\trt\,t classes. 




e 


This Cinroir is because you have 

absi\rad-t methods without Ay 

todt The 乙 ompil 饮 woh'-t let you 

ms-tah-tia-tc a dass wi-th missih^ 
just like it wouldh ; -t let you 

i^s-tahtiatc 
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interfaces and abstract classes 



O 


VOAIT, WHAT? a 6UASS THAT 工 
INSTANTIATB? VOHY W^UUD I BVBN WANT 
SOMETH I UKB THAT? 


HevVs a dlass mat i\\t Objcdtvillc 
J\sbro^\^ Club uses *to stY\d 
七 v-o^kc*b bo diKerwb flar\cts. ^ 


class PlanetMission { 

public long RocketFuelPerMile; 
public long RocketSpeedMPH; 
public int MilesToPlanet; 


Because you want to provide some code, but 

still require that subclasses fill in the rest of the code. 

Sometimes bad things happen when you create objects that should never be 
created. The class at the top of your class diagram usually has some fields that it 
expects its subclasses to set. An Animal class may have a calculation that depends on 
a Boolean called HasTail or Vertebrate, but there’s no way for it to set that itself. 

丁 he as-t\rof>hys*utis-b have -two 
•^issiohs—ohC -fco A1s\rs, ^hd 
io \/chus. 

class Venus : PlanetMission { 
public Venus() { 

MilesToPlanet = 40000000; 


Here’s an example. 


It does^i make sck^sc -fco 
set these -fields ih the 
base dass, bemuse we 
dor /七 khow whclt \rodkct 

饮 plahet well be us'rn^. 


public long UnitsOfFuelNeeded() { 

return MilesToPlanet * RocketFuelPerMile; 


public int TimeNeeded() 
return MilesToPlanet 


(int) RocketSpeedMPH; 


public string FuelNeeded() { 

return "You^11 need " 

+ MilesToPlanet * RocketFuelPerMile 
+ " units of fuel to get there. 工 tH take 
+ TimeNeeded() + " hours."; 


RocketFuelPerMile = 100000 
RocketSpeedMPH = 25000; 


class Mars : PlanetMission { 
public Mars() { 

MilesToPlanet = 75000000; 
RocketFuelPerMile = 100000; 
RocketSpeedMPH = 25000; 

} 

} dor\s*tvud*toV"S -fov and Versus 

subclasses sti *tKc fields they 

But tKosc fields v/oir/1 y 七 sti 
you *msiav>tia*tc Pla^ciMissio^ d^cd-tly. So 
happens FucINccdcdO ivies *to use i\\t^ 


private void buttonl_Click(object s , EventArgs e) 
Mars mars = new Mars(); 

MessageBox . Show (mars . FuelNeeded () ) ; 


private void button2_Click(object s , EventArgs e) 
Venus venus = new Venus(); 

MessageBox . Show (venus . FuelNeeded () ) ; 


You'll need 7500000000000 units of fuel to get there. It’ll take 3000 hours. 


private void button3_Click(object s, EventArgs e) 
PlanetMission planet = new PlanetMission(); 
MessageBox . Show (planet. FuelNeeded () ) ; 



Before you flip the page, try to 
figure out what will happen when 
the user clicks the third button... 


you are here ► 
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abstract classes avoid this mess 


Like we said, some classes should never be instantiated 


The problems all start when you create an instance of the 
PlanetMission class. Its FuelNeeded () method 
expects the fields to be set by the subclass. But when they 
aren’t, they get their default values — zero. And when G# 
tries to divide a number by zero … 

private void button3_Click(object s , EventArgs e) { 
PlanetMission planet = new PlanetMission(); 
MessageBox.Show(planet.FuelNeeded ()); 


M b> dWidc 

ky Rodkc*tS?ccdMPn, 

•rt v/as zjCVo- 

you d'Widc ^7 七 



The Pbhc-t/VJissioh <ilass 
wash 七 y/\riiic^ io be 
inhaled. wcv-c ohly 
supposed io ihhcHt 

•t. Bui wc did ihsbhtiatc 
1 七 ahd "tWs whcv-c -the 

proble 州 s si3\ricd. 


Microsoft Visual Studio\(press 2012 for Windows Desktop 


An unhandled exception of type 'System.DivideByZeroException' occurred in 
PlanetMission.exe 

Additional information: Attempted to divide by zero. 


I I Break when this exception type is thrown 

Open Exception Settings 


Break 


Continue 


Ignore 


Solution: use an abstract class 

When you mark a class abstract, G# won’t let you write 
code to instantiate it. It’s a lot like an interface — it acts like a 
template for the classes that inherit from it. 


tdd'm^ abs-tv-att kcy>wovd *to 
.lass dctlav-atio^ -tclU C^r -this is 


■d *to 

dldss dcdlav-atio^ tells this is dh 
abs*tva^*t dlass, dr\d da^*t be ms*ta 灼 *tia*ted. 


\rc-pusc -to Compile 
ou\r p\rog\rarw uhtil 
wc \rcmovc the 
li ⑽ that ^\rcatcs 

扣 ihS-tahdc of 

PUhctMissioh. 


Now c# will (abstrac^class PlanetMission 


} 


public long RocketFuelPerMile; 
public long RocketSpeedMPH; 
public int MilesToPlanet; 

public long UnitsOfFuelNeeded() { 

return MilesToPlanet * RocketFuelPerMile • 

} 

// the rest of the class is defined here 

Flip back to the solution to Kathleen’s party planning program in 
the previous chapter, and take another look at the class hierarchy. 
Would it ever make sense to instantiate Party, or would it make 
more sense to mark it as abstract to prevent that? 
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interfaces and abstract classes 


Aw abstract method doesn't have a body 

You know how an interface only has declarations for methods and properties, but 
it doesn’t actually have any method bodies? That’s because every method in an 
interface is an abstract method. So let’s implement it! Once we do, the error 
will go away. Any time you extend an abstract class, you need to make sure that 
you override all of its abstract methods. Luckily, the IDE makes this job easier. 
Just type “public override” 一 as soon as you press space, the IDE will display 
a drop-down box with a list of any methods that you can override. Select the 
SetMissionlnf o () method and fill it in: 

abstract class PlanetMission { 


Every method in an interface 
is automatically abstract, 
so you don’t need to use 
the abstract keyword in an 
interface，just in an abstract 
class. Abstract classes can 
have abstract methods, but 
they can have concrete 
methods too. 


public(abstract void SetMissionlnfo( 

int mile¥ToPlanet r int rocketFuelPerMile r 
long rocketSpeedMPH); 



// the rest of the class... 

This absbra 心 etW is 〆 f 七 : 上：孓二 PUe-tMiss''<>« ^as 

^ ^ 一 e . 

If we add that method in and try to build 
the program, the IDE gives us an error: 


'VenusMission 7, does not implement inherited abstract 
member 'PlanetMission•SetMissionlnfo(int, int, long) 


So let’s implement it! Once we do, the error will go away. 



class Venus 


PlanetMission 


rt 

-(•yow 3^ abstvat 七 

tlass, y° u 灼 ced 

SetMissionlnfo (40000000, 100000, 25000) ; dll ^ 


public Venus() 







public override void SetMissionlnfo(int milesToPlanet, int rocketFuelPerMile , 
long rocketSpeedMPH) { 

this.MilesToPlanet = milesToPlanet; 

this.RocketFuelPerMile = rocketFuelPerMile; 

this.RocketSpeedMPH = rocketSpeedMPH; 


The Mars class looks just like Venus, except with different numbers. 

What do you think about this class hierarchy? 

Does it really make sense to make SetMissionlnfo() abstract? you are here ► 

Should it be a concrete method in the PlanetMission class instead? 
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c^^rpen 


your pencil_ 

Here’s your chance to demonstrate your artistic abilities. On the left you’ll find sets 
of class and interface declarations. Your job is to draw the associated class diagrams 
on the right. We did the first one for you. Don’t forget to use a dashed line for 
implementing an interface and a solid line for inheriting from a class. 


frivew: 

1) interface Foo { } 

class Bar : Foo { } 


interface Vinn 


abstract class Vout : Vinn 


What's the picture ? 



"""" ^itvtcv-Padc) 
Foo 






abstract class Muffie : Whuffie { } 

class Fluffie : Muffie { } 

interface Whuffie { } 



4) 


class 

Zoop { 

} 

class 

Boop : 

Zoop 

class 

Goop : 

Boop 


4) 


5) 

class Gamma : Delta, Epsilon { } 

interface Epsilon { } 

interface Beta { } 

class Alpha : Gamma,Beta { } 
class Delta { } 


5) 
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interfaces and abstract classes 


On the left you’ll find sets of class diagrams. Your job is to turn 
these into valid C# declarations. We did number 1 for you. 


frivew: 



What's the declaration ? 

|J fublid dldss Cli 匕 k { } 

fublid dldss Cla 匕 k : Clidk {} 


2 ) 



4) 


5) 


KEY - 

extends 
implements 
class 
interface 
abstract class 



you are here ► 
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Fireside Chats 



Tonight’s talk ： An abstract class and an interface butt heads 
over the pressing question, “Who’s more important?” 


Interface: 


I think it’s obvious who’s more important between the 
two of us. Programmers need me to get their jobs done. 
Let’s face it. You don’t even come close. 


Nice. This oughta be good. 


You can’t really think you’re more important than 
me. You don’t even use real inheritance — you only get 
implemented. 


Better? You’re nuts. I’m much more flexible than you. 
I can have abstract methods or concrete ones. I can 
even have virtual methods if I want. Sure, I can’t be 
instantiated — but then, neither can you. And I can do 
pretty much anything else a regular class does. 


c^terpen your pencil 


Great, here we go again. Interfaces don’t use real 
inheritance. Interfaces only implement. That’s just plain 
ignorant. Implementation is as good as inheritance. In 
fact, it’s better! 


Yeah? What if you want a class that inherits from 
you and your buddy? You can’t inherit from two 
classes. You have to choose which class to inherit from. 
And that’s just plain rude! There’s no limit to the number 
of interfaces a class can implement. Talk about flexible! 
With me, a programmer can make a class do anything. 


.m-tcv-Padc) 

1/mn 


Vou-t 


多） ^Ti»vtcv-fa£.c) 


4 ) 


Whafs the picture ? 
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interfaces and abstract classes 


Abstract Class 


Interface 


You might be overstating your power a little bit. 


You think that just because you can contain code, 
you’re the greatest thing since sliced bread. But 
you can’t change the fact that a program can only 
inherit from one class at a time. So you’re a little 
limited. Sure, I can’t include any code. But really, 
code is overrated. 


That’s exactly the kind of drivel I’d expect from an 
interface. Code is extremely important! It’s what 
makes your programs run. 


Nine times out of ten, a programmer wants to make 
sure an object has certain properties and methods, 
but doesn’t really care how they’re implemented. 


Really? I doubt that — programmers always care 
what’s in their properties and methods. 


OK, sure. Eventually. But think about how many 
times you’ve seen a programmer write a method 
that takes an object that just needs to have a certain 
method, and it doesn’t really matter right at that 
very moment exactly how the method’s built. Just 
that it’s there. So bang! The programmer just needs 
to write an interface. Problem solved! 


Yeah, sure, tell a coder he can’t code. 


Y^\iditever\ 




abs*brad 七 dass Fi : Fee { } 


4) Foo { } 

dass Bay : Foo {} 
dass Boiz. : Bav {} 


5) 'Z-tia { } 

dass Alpha : {} 

m-tev-fade dcia { } 
dass Dcl-ta : Brta {} 





What's the declaration ? 


you are here ► 
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multiple inheritance stinks 



I X M STILL HUM 夕 UP ON biOT ABUB 

TO INHERIT FEOM TVJO 6UASSBS- I ^AM X T 
INHBEIT FRm THAN ObiB fiUASS, SOI 

HAVE TO USB INTERFACES- THAT，S A PEBTTY Bl 夕 
UIMITATI^M OF C^ f RI&HT? 



It’s not a limitation, it’s a protection. 

If G# let you inherit from more than one base class, it would 
open up a whole can of worms. When a language lets one 
subclass inherit from two base classes, it’s called multiple 
inheritance. And by giving you interfaces instead, G# saves 
you from a big fat mess that we like to call... 

The Deadly Diamond of Deati! 


Television dr^d MovicT^catcv “〜七 

^om MovicPlay^> ar^d override tVic 

SMo^hMoyj\tO mc^od. boi\\ i\\t 

Stvcc^idtii pvopcvty, *too- 


MoviePlayer 

int ScreenWidth 


ShowAMovie() 



Television 


MovieTheater 




ShowAMovie() 


ShowAMovie() 



I 却 c 一 

? vov^ » s u c 1 vaWcs. 

Mov\cTV^catcr, Vi ^ TV>ca -tcv r^ccds -to 

: = 工一恭。一 d 

JfcaWc 


HomeTheater 




? 

■ 


^°^A/l/lovic() lL 


Avoid ambiguity! 


A language that allows the Deadly Diamond of Death can lead to some 
pretty ugly situations, because you need special rules to deal with this kind 
of ambiguous situation.. .which means extra work for you when you’re 
building your program! G# protects you from having to deal with this by 
giving you interfaces. If Television and MovieTheater are interfaces 
instead of classes, then the same ShowAMovie () method can satisfy both 
of them. All the interface cares about is that there’s some method called 


ShowAMovie(). 
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interfaces and abstract classes 



Paa] Puzzjc 


Your job is to take code snippets from the pool and place them 
into the blank lines in the code and output. You may use the 
same snippet more than once, and you won’t need to use all the 
snippets. Your goal is to make a set of classes that will compile 
and run and produce the output listed. 


Nose 


string Face { get; } 


class . : .{ 

public Acts() : base("Acts") 

public override { 

return 5; 


abstract class . : .{ 

public virtual int Ear () 

{ 

return 7; 

} 

public Picasso(string face) 

{ 

—face; 


fWs the e 士 y poiht—this is 
匕 。… plctc C# pvogvam. 


a 



public virtual string Face 


string face; 


class : 

public Clowns() 


: base("Clowns") 


class : { 

public override string Face { 

1 get { return "Of76"; } 

public static void Main(string[] args) { 

string result =""; 

Nose [ ] i = new Nose[3]; 

i[0] = new Acts(); 

i[1] = new Clowns(); 

i [2 ] = new Of 76(); 

for (int x = 0; x < 3; x++) { 

result += ( + "" 

+ ) + n \n' 

} . 

Console.WriteLine(result); 

Console.ReadKey(); 


Note: each snippet 
from the pool can 
be used more than 
once! 



Answers on page 348. 


you are here ► 
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form of...a bucket of eagles! 



OK, I THINK. 
iVe &OI (\ PJZBTTY 
HANt>UB OK 
OBJECTS N^wi 


卯乜 ahd you 以 ode i 山 
classes ^hd objed^ts wds a 
|rcvolut,ohavy G hC whch it was 
七 ihtirodu^d-bu-t tha^s how 

y° uvc ^ buildmg all y 。 ⑽ C# 

p^oy-ams so (a^r, so you thihk 
o+ It as just plai h pirogvdmmihg. 


You’re an object-oriented programmer. 

There’s a name for what you’ve been doing. It’s called 

object-oriented programming, or OOP. Before 
languages like G# came along, people didn’t use 
objects and methods when writing their code. They 
just used functions (which is what they call methods in 
a non-OOP program) that were all in one place 



-as 


if each program were just one big static class that only 
had static methods. It made it a lot harder to create 
programs that modeled the problems they were solving. 
Luckily, you’ll never have to write programs without 
OOP, because it’s a core part of G#. 


The four principles of object-oriented programming 

When programmers talk about OOP, they’re referring to four important principles 
They should seem very familiar to you by now because you’ve been working 
with every one of them. You’ll recognize the first three principles just from their 
names: inheritance, abstraction, and encapsulation. The last one’s called 
polymorphism. It sounds a little odd, but it turns out that you already know all 
about it too. 

TV>is jus*t 扣 s oir^C 

t\Bss ov m*tcv-fadc 
mKcv-'rU -fv-om 

考 Inkeritance < - ^ r t • 

Encapsulation 




T dt,> 

r . / J , , that kc «ps br^tV 
p .. J '^^hally usi h a 
fields, uses F ubl 

^ e ^! CS 3hd ^i^ods -to lei 

i, C，r wo^rk with ohly 





)c y io 




肴 


Abstraction 

x/ouVc usm^ v/Kcn 70U 小 

trtait a tlass model stav-b I 

讀 t ywal -饮 akst^ra^t asses, / 

一七 b 心 mo 代 s^tc\\\c classes * 

mV^rt 心 0 州•七 V 


r 

Polymorpliisin 


-tWmk 


TV v/ovd w — ’ 

l\*bcvally ^cay\s 

a tiwc av> objed 七 

has -takcy\ oy\ nxBy^ \orr^s 
•m yo^r todc? 
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Polymorphism means that owe object 
can take many different forms 

Any time you use a mockingbird in place of an animal or aged 
Vermont cheddar in a recipe that just calls for cheese, you’re using 
polymorphism. That’s what you’re doing any time you upcast or 
downcast. It’s taking an object and using it in a method or a statement 
that expects something else. 


Keep your eyes open for polymorphism m the next 
exercise! 

You’re about to do a really big exercise — the biggest one you’ve seen so 
far — and you’ll be using a lot of polymorphism in it, so keep your eyes 
open. Here’s a list of four typical ways that you’ll use polymorphism. We 
gave you an example of each of them (you won’t see these particular lines 
in the exercise, though). As soon as you see similar code in what you write 
for the exercise, check it off the following list: 


Taking any reference variable that uses one class and setting it 
equal to an instance of a different class. 

NectarStinger bertha = new NectarStinger (); 
INec tar Co Hector gatherer = bertha; 


You re using 
polymorpliisiii 
wken you take an 
instance ol one 
class and use it 
in a statement or 
a metlioct tkat 
expects a diHerent 
type, like a 
parent class or an 
interface tkat tke 
class implements* 


Upcasting by using a subclass in a statement or method that expects its 


base class. 

spot = new Dog (); 
zooKeeper.FeedAnAnimal(spot); 



p 拉 Do 3 io ⑽ 10. 7 


Creating a reference variable whose type is an interface and 
pointing it to an object that implements that interface. 

工 StingPatrol defender = new StingPatrol(); 


TWis IS ufdastmj, -tool 


Downcasting using the as keyword, 
void MaintainTheHive(IWorker worker) 
if (worker is HiveMaintainer) { 

HiveMaintainer maintainer = 



|\A/ovkcv as a \i ^ as ^ 

pom 七 a ttwcMamtamCV to the 


jovkcv". 


worker as HiveMaintainer 


you are here ► 
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let’s get started 





Let’s build a house! Create a model of a house using classes to represent the 
rooms and locations, and an interface for any place that has a door. 


o 


o 


Start with this class model. 

Every room or location in your house will be represented by its own 
object. The interior rooms all inherit from Room, and the outside 
places inherit from Outside, and both subclass the same base 
class, Location. The Name property is the name of the location 
(“Kitchen”). The Exits field is an array of Location objects 
that the current location connects to. So diningRoom. Name will 
be equal to "Dining Room", and diningRoom. Exits will be 
equal to the array { LivingRoom, Kitchen }. 

♦ Create a Windows Forms Application project and add 
Location, Room, and Outside classes to it. 


You'll need the blueprint for the house. 

This house has three rooms, a front yard, a back yard, and 
a garden. There are two doors: the front door connects the 
living room to the front yard, and the back door connects 
the kitchen to the back yard. 


Location 


Name 

Exits 

Description 



L-oda*tioh is dh 
abs-t\ra^-t dass. 

That s why 
wc shaded i-t 
dairkeir ih the 

匕 lass diaAiram. 



Room 


Outside 

decoration: 


hot: private 

private string 


bool field 

field 







Inside lodatiohs eddli have 
some kihd a dc^ov-atioh 
•m a private -field- 



The livm^ room 

*bo 

■blr^C voom, 

y/hidh also 
*bo 
■bKc 



This symbol is c^icv-iov- door 

between -the yav-d and -the livmg 
\room. Thcv-c^s also av\ c^icv-iov- dooy 

between the ki-Uhc^ b 把 k yard- 


❺ 


Outs'idc lota-t'io^s tav\ 
be so *tKc 0 uts.de 
tlass Kas a pwa 七 c 
Boolean Acid tailed Hot 

You tay\ move 
betweeh the badk 
yard ahd the -P\roh*t 
y3i>rd) clhd both of 
■them {jo *thc 

ga^rdch. 


AH v-oorws have doo\rs ; but ov\\y d -Pew 
\rooms have av\ door ihai 

leads inside o\r ou-tsidc 七 he house- 


Use the iHasExteriorDoor interface for rooms with an exterior door. 

There are two exterior doors in the house, the front door and the back door. Every 
location that has one (the front yard, back yard, living room, and kitchen) should 
implement IHasExteriorDoor. The DoorDe script ion read-only property 
contains a description of the door (the front door is “an oak door with a brass knob,” 
and the back door is “a screen door’’). The DoorLocation property contains a 
reference to the Location where the door leads (kitchen). 


IHasExteriorDoor 


DoorDescription 

DoorLocation 
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interfaces and abstract classes 


O Here’s the Location class. 

To get you started, here’s the Location class: 

abstract class Location { 

public Location(string name) 
Name = name; 


The sets -the hamc -field, 

wkh is the ⑽ d-o h |y Naw pvopc^y. 


Dcsdvip-tioh 
is a viv-tuoll 
p\ropc\rty. 
Voull y\ttd {jo 

ovcv\ridc it- 


TKc E/rb Acid • 丨 s a” avvay <^f 
UuW ^W^cs *tKat kcc ? s bracM 
of all of 仏 C plates i^at i^»s 

loda 七 icm towct*b *to- 

public string Name { get; private set; } 


public Location[] Exits; 




T\\t base Pes^riftio” 
fv-ofev-ty v-ctuv-^s d s-tv-'mj 
dcsdv-'ibcs i)nt \room, 

’mdudm^ y\ 3 mc 3 ^d 3 l ,s *t 
J< all o-f Ic^a 七 iems rt 

dor\r\Cd*b *to (y/WiA Vt <fmds 

*m E%i*bC 3 -field). Its 
subclasses y/*ill v\ttA *to 
{\\t dcs 6 v-*i\>*b*»oh so 

*tiicY ， ll ovevVide it } 


public virtual string Description { 
get { 

string description = "You^re standing in the 



+ Name 


+ ". You see exits to the following places : 
for (int i = 0; i < Exits.Length; i++) { 

description += " " + Exits[i].Name; 
if (i != Exits.Length - 1) 
description +=","; 


description += ▼'•，，； 
return description; 




TKc Room 
dldss v/ill 
ovcv-vidc 

ar\d 

Pcsdv'ip*tior> 
bo add i\\t 
dctovatio^, 

av\d Outside 
y/ill ddd *kKe 
temfeva 七 uve. 


尺„一 Lo^aiioh is ah 
^l^ss-you 

W ii a h d dc ^ c 

代 W “ variables o-P iype 

Loda-tioh, bu-t you 乙 3 k / 七 
ii 



Create the classes. 

First create the Room and Outside classes based on the class model. Then 
create two more classes: OutsideWithDoor, which inherits from Outside 
and implements IHasExteriorDoor, and RoomWithDoor, which subclasses 

Room and implements IHasExteriorDoor. ^ ^ dasscs siaritd how-well give you 

Here are the class declarations to give you a leg up: dctails about therw oh the hext 

class OutsideWithDoor : Outside, IHasExteriorDoor 


rwo\rc 


// The DoorLocation property goes here 
// The read-only DoorDescription property goes here 


class RoomWithDoor : Room, IHasExteriorDoor 

{ 

// The DoorLocation property goes here 
// The read-only DoorDescription property goes here 


This one’s going 
to be a pretty big 
exercise...but we 
promise it’s a lot 
of fun! And you’ll 
definitely know this 
stuff once you get 
through it. 


-► 


Wre not done yet-flip the pa^e! 


you are here ► 
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watch your objects do stuff! 



ton% (cpHtiHv 6 p) 



Now that you’ve got the class model, you can create the objects for all of the parts of the 
house, and add a form to explore it. 


Here's how your house objects work. 

Here’s the architecture for two of your objects, front Yard and livingRoom. Since each of 
them has a door, they both need to be instances of a class that implements 工 HasExteriorDoor. 
The Door Location property keeps a reference to the location on the other side of the door. 

LivmgRoom is of 

Room^/i*thPooV", whidh 'mhcvi*ts 
-fvom Room ar\d 
IttasE'X.'tcv-iov-Doov-. 


°^/de ( 50 、 


By\ 

Ou-b'idclA/^Poov- 
object, v/Wi 乩 is a 
suotlass <Jc Outside 
七七 

I HasE^tcv-'iov-Poov-. 


DoorLocation 




% Ob〆 



DoorLocation 


o 


You started build'mg the |ttas£y.icv-iov-poo\r 
m-tev-fade by\A added these two classes that 
implement it- Or\t mhev-rts -fv-om Room ； the o*thc\r is 
a subdlass o( Outside. Now its time bo -Pmisii them. 


Exits[| 

is a 灼 av-vay Location 

vc-fcvcr>tcs. Liv'm^Room lias 

O^e so its 6%i*b avray 
Kas a \tY\Oj^ <^f I- 


is 

av-vay o-f 4 


Finish building the classes, and instantiate their instances. 

You’ve got all the classes — now it’s time to finish them and build your objects. 

★ You’ll need to make sure that the constructor for the Outside class sets the read-only Hot property and 
overrides the Description property to add the text “It’s very hot here.” if Hot is true. It’s hot in the 
back yard, but not the front yard or garden. 

* The constructor for Room needs to set the Decoration, and should override the Description property 
to add, “You see (the decoration )The living room has an antique carpet, the dining room has a crystal 
chandelier, and the kitchen has stainless steel appliances and a screen door that leads to the back yard. 

* Your form needs to create each of the objects and keep a reference to each one. So add a method to the 

form called CreateOb j ects () and call it from the form’s constructor. £\/ev*y lodatio^ 

★ Instantiate each of the objects for the six locations in the house. Here’s one of those lines: will have its 

ovm -field m 
the -form dlass. 


RoomWithDoor livingRoom = 

"an antique carpet" , "an oak door with a brass knob") 
Your CreateOb j ects () method needs to populate the Exits [ ] field in each object: 


new RoomWithDoor("Living Room ", 
"an oak door with a brass knob' 


Loda 七 ior\ 

so 七 iVis Ime ^ 

dvca*tcs ont 七 has 

•fcwo vc-fcvci^dcs m i*t- 


frontYard.Exits — new Location[]’ {)backYard, garden 


Tiicsc avc 
tuv-ly brackets. 
-A^ybK'm^ else y/ill 
乙 3usc cvrov. 
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o 


o 


Build a form to explore the house. 

Build a simple form to let you explore the house. It’ll have a big multiline text box called 
description to show the description of the current room. A ComboBox called exits lists 
all of the exits in the current room. It’s got two buttons: goHere moves to the room selected in 
the ComboBox, and goThroughTheDoor is only visible when there’s an exterior door. } 

set uV ^ 


Clidk 

but-fcoh -to move -fco 

dhothev* lodatioh. 


□ J 

Explore the House 




This is d 

displays -the Pcs^viftiohO 

lo 乙 Its is 

dcs^\rip*tioir\. 


Go here: 


This is B ComboBox 


Go through the door 



Combofto^- 

The ComboBox. ^o^-bd'ms a 
lis*t o-f dll o( *thc c>^i*tsi so 
ir^amc i*t Make suv-c 
i*ts Dv-opDow^S*tylc is se 七 
*to D\ropDow^Lis*t. 

This butbw is only visible 

y^\\tY\ you’ve m a v-oom v/rtii 
3^ c%*tcvio\r door- ^/o\a 
make i*b visible ov mvisible by 
»*b Visible profcrty 
■{jo "tvuc ov* -("disc* l*ts £.dllcd 

Make the form work! ^oTWou^ncPoor. 

You’ve got all the pieces; now you just need to put them together. 

* You’ll need a field in your form called currentLocation to keep track of your current locatio 

* Add a MoveToANewLocation () method that has a Location as its parameter. This 
method should first set currentLocation to the new location. Then it’ll clear the combo 
box using its Items . Clear ( ) method, and then add the name of each location in the 
Exits [ ] array using the combo box’s I terns • Add () method. Finally, reset the combo box 
so it displays the first item in the list by setting its Selectedlndex property to zero. 

* Set the text box so that it has the description of the current location. 

* Use the is keyword to check if the current location has a door. If it does, make the “Go 
through the door” button visible using its Visible property. If not, make it invisible. 

If the “Go here:” button is clicked, move to the location selected in the combo box. 

* If the “Go through the door’’ button is clicked, move to the location that the door connects to. 




七 : you tlioosc By\ m Covr\)o \)o%, i*b 
St\tcitd mdc% m i\\t dombo bo% v/ill be i\\t as i\\t 

mdc% {}\t dovvespo^dm^ lotatior\ m 6%rb[] 狀⑸丫. 


hiht Vou\r (o^rJs ^u\r\rCh-tLo^atioh -field is 
a £0 cvch though i-fc s pomtmg 

■to 扣 o)o\tti -thol-t implcmch-ts (HolsExlcv-iov-Doo^ 

you just type ^umhtLo^tioh.Doov-Lodat.oh W 
^ ； ausc Voo\rLoC.ahov\ ish't a -field ih Lotahov\. 

咖 d "to dowh^sl you io -the door 
lo^atioh out o-P the object. 


you are here ► 
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exercise solution 



tog ExjRdSe 
SPLvtiPH 


Here’s the code to model the house. We used classes to represent the rooms 
and locations, and an interface for any place that has a door. 


interface 工 HasExteriorDoor { 

string DoorDescription { get; } 
Location DoorLocation { get; set; 





class Room : Location { 、 

private string decoration; 

public Room(string name, string decoration) 

: base(name) { 

this.decoration = decoration; 

} 

public override string Description { 
get { 

return base. Description + ▼，You see " + decoration + 


Th: Room dass ihhcirits Lodatioh 

i dds a 4, the d^ahoy. 

Its ^Ohstv-u^-tov sets -the -field. 



class RoomWithDoor : Room, 工 HasExteriorDoor { 

public RoomWithDoor(string name, string decoration, string doorDescription) 
: base(name, decoration) 


DoorDescription = doorDescription; 

} 

public string DoorDescription { get; private 
public Location DoorLocation { get; set; } 

} 

Did you use backing fields instead 
of automatic properties? That’s a 
perfectly valid solution, too. 



set; } RoomlVi*bKPoov tlass 'mKc\ri*bs 
-pvom Room implcrr»Cr\*ts 

IH'asE'X.tcv-iovPoov. |*t docs 

voom docs, but adds a 
dcsdv-if*t*ioy> door 

-to doy>s*tvud*bov-. |*t also adds 
t)oorLotahoY\, d \rc-fcv-cr>dc *to 七 he 
lodatior^ door leads -to. 

PoovPcs£.v-ip*tior\ av>d PoovLodatior\ 
av-c v-c<\uivcd by |ttasE%*tcv-*io\rPoov-. 
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class Outside : Location { 
private bool hot; 

public Outside(string name, 
: base(name) 

{ 

this.hot = hot; 


bool 



Outside is d lo*t like Room—i*t 
mKcv-i*U -fv-om Lodatior^, a^d adds a 
pvWa*tc -field -fov H ■。七 pv-ofcv*ty> 

^\cM is used m 七 he Pes^riptio 的 0 
mciKod extended -fvom *tKc base 
tlass. 


public override string Description { 
get { 

string newDescription = base.Description; 
if (hot) 

newDescription +=" 工 t f s very hot."; 
return newDescription; 


class OutsideWithDoor : Outside, 工 HasExteriorDoor { 

public OutsideWithDoor(string name, bool hot, string doorDescription) 


: base(name, hot) 

this.DoorDescription = doorDescription; 


K 土二 。 r 祕。 ks a w 


public string DoorDescription { get; private set; } 
public Location DoorLocation { get; set; } 


public override string Description { 
get { 

return base.Description + " 


You see " + DoorDescription + 


The base dlass s Pcsdv-iftio^ pv-ofev-ty 
-Pills m y/hc*thcv- ov y\o{, the lodatioh 
is hot v-clics OY\ the ov-ij'mal 

LotahoY\ dlasss pesdv-iftio^ p\rofCV-ty 
七 。 add the w>a'm desdv-iftio^ a^d c^its. 



Wre not done yet-Elip the pa^e! 


► 


you are here ► 
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tp^S Bmc^ —-- 

§PLiitiPH (cPHtiHv<ep) 


Here’s the code for the form. It's all in the Forml.cs file, inside the Forml declaration. 


public partial class Forml : Form 


Location currentLocation; 


RoomWithDoor livingRoom; 
Room diningRoom; 
RoomWithDoor kitchen; 

OutsideWithDoor frontYard; 
OutsideWithDoor backYard; 
Outside garden; 

public Forml() { 

工 nitializeComponentO'- 
CreateObjectsO; 



TVis IS how keeps br^ck 

(Jc ^i\\\cM room is bcmj displayed- 



丁 he -Po\rm uses these 
variables -to keep o( eadk 

七 he \roorns ih Kousc. 


We made Exits a public 
string array field in the 
Location class. This is 
not a great example of 
encapsulation! Another 
object could easily 
modify the Exits array. 
In the next chapter, you’ll 
learn about a better way 
to expose a sequence of 
strings or other objects. 


MoveToANewLocation(livingRoom) jj 


T\\t (orvr!s toy>s*tvud*bov- dv-ca*tcs 
-tKc objects dr^d uses i\)t 
\ MovcToANcv/Lodatior^ mciliod. 



an antique carpet' 


private void CreateObjects() { 

livingRoom = new RoomWithDoor("Living Room ", 

"an oak door with a brass knob"); 
diningRoom = new Room (，’ Dining Room”，"a crystal chandelier"); 
kitchen = new RoomWithDoor("Kitchen", "stainless steel appliances 


-tKc -fov-m ^eaies 
the ob\c^ -fiv-s-t i-t 
^ds to ihs-bh-tia-tc 
"the dUsscs ahd pass -the 
hght ih-fov^ma-tioh -to 
ohc s 匕。 hs*bru 匕 "tov*. 


a screen door '，）； 


frontYard = new OutsideWithDoor("Front Yard' 
backYard = new OutsideWithDoor("Back Yard ", 
garden = new Outside("Garden ", false); 


false, 
true, "a 


diningRoom.Exits = new Location[] { livingRoom, kitchen 

livingRoom.Exits = new Location[] { diningRoom }; 

kitchen.Exits = new Location[] { diningRoom }; 

frontYard.Exits = new Location[] { backYard, garden 

backYard.Exits = new Location[] { frontYard, garden 

garden.Exits = new Location[] { backYard, frontYard 


"an oak door with a brass knob"); 
screen door ，'）； 

Hcv-c^s wc fass 

ihc door dcsCr\ybor\ *to 
七 he Ou*bidcl/V'»*bV>Poo\r 
tor\s*tv"ut*tovs. 


livingRoom.DoorLocation 
frontYard.DoorLocation : 

kitchen. DoorLocation •- 
backYard.DoorLocation 


： frontYard; 
=livingRoom; 

backYard; 

: kitchen; 




& the IHasB^ieHo^rPooir 
objects, wc wd "to sci 

"theiir doo\r lo^ 3 "tiohS. 


-fov eddii ms*ta^dc is populated- 
Wc r\tt& *to *to do *tKis 
U y>til a-f*tcv- all i\\t *msiay>dcs avc 
dvca*tcd, bcdausc v/e 

v/ould^t Kavc *to fu 七 m*to 

eadii av-vay! 
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private void MoveToANewLocation(Location newLocation) { 

currentLocation = newLocation; Tk AWTo 她 wLo^W) method 

displays a hew lodatioh ih -the (c 

exits . 工 terns • Clear (); 

for (int i = 0; i < currentLocation.Exits.Length; i++) 


rov*m. 


exits. 工 terns.Add(currentLocation.Exits[i].Name) 
exits•Selectedlndex = 0; 

description.Text = currentLocation.Description; 

if (currentLocation is IHasExteriorDoor) 
goThroughTheDoor.Visible = true; 

else 

goThroughTheDoor.Visible = false; 

(This makes i\\t KK 6{o 七 Wou# 七 he Aooy button ^visible i-P i\\C 
duv*v*Cr>*t lodd*kio^ doesn't Ittas6%*tcv*io\rPoov. 



Pivs*t v/c y\tt& *to dlcav* 七 he dombo 
bo%, dv>d >wc car\ add cadh o( 七 he 
loda*t*ioy>s ； y>amcs *to *i*t- Fmally, >MC sc*t 
•rU sclcd*tcd mdc% (or ^i\\\cM Imc is 
七 ed) *to zjCv-o so *i*t sKov/s 七 he 
•f ivs*t rtdm 七 lis 七 • Do 的七 -fov*^c*t *to 
se 七七 he ComboBo^s Pv-opPov/r>S*tylc 
pvopcv**ty *to PvopPo>wir>Lis*t 一七 ha 七 
v/ay ; 七 i 化 usev- \wo^*t be able *to *tyfc 
m*to *tV>C dombo bo%. 


private void goHere_Click(object sender, EventArgs e) { 

MoveToANewLocation(currentLocation.Exits[exits•Selectedlndex]); 


private void goThroughTheDoor_Click(object sender, EventArgs e) { 
IHasExteriorDoor hasDoor = currentLocation as IHasExteriorDoor, 
MoveToANewLocation(hasDoor.DoorLocation); 


*biic user dl'itks 
i\\t w ^o lou 七 W 

i 七 moves bo 七 he 
lo^at»or\ selected *m 
■tW tombo bo%- 







We r\ttA bo use 七 he as kcyv/o\rd *m order 
{jo dovmddsi duVVC^*tLoda*tioy> *to 3ir> 
|H'asS%*tcviovPoov so v/c d3y> yt addess *to 
-tKc PoovLodatior> -f ield- 


Put we're not done yet! 






It’s fine to create a model of a house, but wouldn’t it be cool to turn it into a game? 
Let’s do it! You’ll play Hide and Seek against the computer. We’ll need to add an 
Opponent class and have him hide in a room. And we’ll need to make the house a 
lot bigger. Oh, and he’ll need someplace to hide! We’ll add a new interface so that 
some rooms can have a hiding place. Finally, we’ll update the form to let you check 
the hiding places, and keep track of how many moves you’ve made trying to find 
your opponent. Sound fun? Definitely! 




-► 


Let’s get started! 


you are here ► 
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build your opponent Here’s the biggest challenge we’ve given you so far. Read the instructions 



carefully! It’s not cheating to peek at the solution. 


o 


Time for hide and seek! Build on your original house program to add more rooms, hiding 

一 


KciSe 


❺ 

O 


We don’t need to do anything fancy here. Any Location subclass that 
implements 工 HidingPlace has a place for the opponent to hide. It just needs a 
string to store the name of the hiding place (“in the closet”, “under the bed”, etc.). 

Give it a get accessor, but no set accessor — we’ll set this in the constructor, since 
once a room has a hiding place we won’t ever need to change it. 

Add classes that implement 工 HidingPlace. 

You’ll need two more classes: OutsideWithHidingPlace (which inherits 
from Outside) and RoomWithHidingPlace (which inherits from Room). 

Also, let’s make any room with a door have a hiding place, so it’ll have to inherit 
from RoomWithHidingPlace instead of Room. So cvcv-y iroorw y/ith c^tcv-iov- doov y/ill 

also have a pladc ： -the has a 

Add a class for your opponent. av\d 七 he livmj y-oom has a dlosct 


We didn’t give you 
a class diagram 
this time, so you 
should grab a piece 
of paper and draw 
it yourself. That will 
help you understand 
the program you 
need to build. 


The Opponent object will find a random hiding place in the house, and it’s your job to find him. 


★ He’ll need a private Location field (myLocation) so he can keep track of where he is, 
and a private Random field (random) to use when he moves to a random hiding place. 

★ The constructor takes the starting location and sets myLocation to it, and sets random 
to a new instance of Random. He starts in the front yard (that’ll be passed in by the form), 
and moves from hiding place to hiding place randomly. He moves 10 times when the game 
starts. When he encounters an exterior door, he flips a coin to figure out whether or not to go 
through it. 

★ Add a Move () method that moves the opponent from his current location to a new location. 
First, if he’s in a room with a door, then he flips a coin to decide whether or not to go through 
the door, so if random. Next (2 ) is equal to 1, he goes through it. Then he chooses one of 
the exits from his current location at random and goes through it. If that location doesn’t have 
a hiding place, then he’ll do it again — he’ll choose a random exit from his current location 
and go there, and he’ll keep doing it over and over until he finds a place to hide. 

★ Add a Check () method that takes a location as a parameter and returns true if he’s hiding 
in that location, or false otherwise. 

o Add more rooms to the house. 

Update your CreateOb j ects () method to add more rooms: 


* Add stairs with a wooden bannister that connect the living room to the upstairs hallway, 
which has a picture of a dog and a closet to hide in. 

★ The upstairs hallway connects to three rooms: a master bedroom with a large bed, a 
second bedroom with a small bed, and a bathroom with a sink and a toilet. Someone 
could hide under the bed in either bedroom or in the shower. 


* The front yard and back yard both connect to the driveway, where someone could hide in 
the garage. Also, someone could hide in the shed in the garden. 
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Don’t forget that there are many ways to solve any programming problem. interfaces and abstract classes 

If your solution is different than ours but it works, that’s great! 


Q OK, it's time to update the form. 

You’ll need to add a few buttons to the form. And we’ll get a little more intricate with 


JLUU 丄丄 LU d 丄 CW kJULLAJ 丄丄 b LU 丄 U 丄丄 WG 丄丄 gCL d 丄丄 LUG 丄 1 丄 U 丄 G 丄丄丄 UL 丄 W 丄 1 丄丄 

making them visible or invisible, depending on the state of the game. TV.C middle called 如戊个 

,,_ dov/t，eed set ^ ^ 


Jo 一印 UMU— 十 : 

N.W.IC *«S 嚕 ’ 

.'J C bu , is ° hl y displayed. 

^ 10 ,h . ; thc ^ box, a h d calls the 
/WovcO method 10 iir, C s. 

1 hch this butU invisible. 



TW«s is i\\t bu*tW use *to 

—7 伽 Vc m a ro r i 
Ja ? Ue*toW,de. ^ 

jfolUed fe；/ 忪一亡 士 
pladc-so kor a voom a . 

say, w CV^c6k uv^dev- hst bed • 


o 


Make the buttons work. 

There are two new buttons to add to the form. 


Flip badk *to 
Ci^aftcv- Z (or 
a vc-rvcsKcv ov> 


* The middle button checks the hiding place in the current room and is only visible when 
you’re in a room with a place to hide using the opponent’s Check () method. If you found 
him, then it resets the game. 


Po£vcir>*bO dr>d * 


SIccpO—II 
dome m Ka^dy- 


The bottom button is how you start the game. It counts to 10 by showing “1 waiting 200 
milliseconds, then showing “2".’’，then “3".’’ ， etc.，in the text box. After each number, it tells 
the opponent to move by calling his Move () method. Then it shows, “Ready or not, here I 
come!” for half a second, and then the game starts. 



o 

o 


Add a method to redraw the form, and another one to reset the game. 

Add a RedrawForm () method that puts the right text in the description text box, makes the buttons 
visible or invisible, and puts the correct label on the middle button. Then add a ResetGame () 
method that’s run when you find your opponent. It resets the opponent object so that he starts in the 
front yard again — he’ll hide when you click the “Hide!” button. It should leave the form with nothing 
but the text box and “Hide!” button visible. The text box should say where you found the opponent, 
and how many moves it took. n irj , 

J ® u Hide and Seek 



Keep track of how many moves the player made. 

Make sure the text box displays the number of times you checked a 
hiding place or moved between rooms. When you find the opponent, 
he should pop up a message box that says, “You found me in X 
moves!” 

Make it look right when you start the program. 

When you first start the program, all you should see is an empty text box 
and the “Hide!” button. When you click the button, the fun begins! 



you are here ► 
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exercise solution 



内 jRciSe 
§PLjitlOH 


Build on your original house program to add more rooms, hiding places, and an opponent who 
hides from you. 

ttcvc s "the hCW Ittidih^Pla^c ihtcv--Cadc. It 
just has Ohc s-t\rih0 -field with a get addessov- 
七 hat vetuv-hs the o( the hidih^ pla 以 . 



interface 工 HidingPlace { 

string HidingPlaceName { get; } 


class RoomWithHidingPlace : Room, 工 HidingPlace { 

public RoomWithHidingPlace(string name, string decoration, string hidingPlaceName) 
: base (name, decoration) 丁 ^ tlass mV^’rb 

{ ^ W Roo. a,d •呵 Uerrb ^ 

HidingPlaceName = hidingPlaceName; addm^ tt'idi'm^PlatcKaw'C \>v-o\>CV-ty- ' 

} £.ohS*tv*ut*tov* sc*ts i*U value. 

public string HidingPlaceName { get; private set; } 

public override string Description { 


get 


return base.Description 


Someone could hide 


HidingPlaceName 


class RoomWithDoor : RoomWithHidingPlace , IHasExteriorDoor { 
public RoomWithDoor(string name, string decoration, 

string hidingPlaceName, string doorDescription) 
: base(name, decoration, hidingPlaceName) 


DoorDescription = doorDescription; 

} 

public string DoorDescription { get; private 
public Location DoorLocation { get; set; } 


Att\AtA cvc\ry v-oom with a 
door also heeded a W\d\v\^ plade ； we 
… ade RoorulM-thPoov- ihhev-it -fv-om 

set; Tk ohly 

' h> it is that its 

Y kcs a hidih 9 a^d schds 

it 咖 "to the RoomlVi-thttidihgPladc 

^OhS-t\rud-fcov-. 


You’ll also need the OutsideWithDoor 
class, which is identical to the version 
from the “Explore the House” program. 
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class OutsideWithHidingPlace : Outside, 工 HidingPlace { 

public OutsideWithHidingPlace(string name, bool hot, string hidingPlaceName) 
: base(name, hot) 


HidingPlaceName = hidingPlaceName; 


The OuisidclViilittidmjPladc dass mhcv-its 
•(Vorw Outside (Hidi^JPUdC 

jusi like Roornl/ViihHid'm^Pladc does. 


public string HidingPlaceName { get; private set; } 

public override string Description { 
get { 

return base.Description + " Someone could hide 


HidingPlaceName 



class Opponent { 

private Random random; 
private Location myLocation; 
public Opponent(Location startingLocation) 
myLocation = startingLocation; 
random = new Random(); 


public void Move() { 

bool hidden = false; 
while (!hidden) { 

if (myLocation is 工 HasExteriorDoor) { 

工 HasExteriorDoor locationWithDoor = 

myLocation as 工 HasExteriorDoor/ 
if (random•Next(2) == 1) 

myLocation = locationWithDoor•DoorLocation; 

} 

int rand = random.Next(myLocation.Exits.Length); 
myLocation = myLocation.Exits[rand]; 
if (myLocation is 工 HidingPlace) 
hidden = true; 


The dlass tor>s*tvud*tov- d 

stav-tmg lodatioy>. |*t ertaits a ^ 

O-P Random, y/K*idK \i uses bo move va^domly 
bc*t>wccir> vooms. 

{ 

The MovcO mciliod -Pivs-t dhcdks i-f -the 
Voorw has d doov usi^ -the is keyv/ovd—i-f so, i*t 
has a ^0% o\ jomj ihiroujh it Then it 

rwoves -to a \ra^dorw lodatio^, ar>d keeps movi^ 
wvtil it -f'mds a hidmg plate. 


TKc ^uts MovcO 

mc*tV)od is *tWis y/Wilc 
loop. It keeps loof'm^ 
\AV\h\ variable Widdc^ 

IS *tv-uc—ar\d it sets \i 

*to *tv*uc >n\\cv\ i*t a 
voom 3 Wui 叫 pla 乙 


public bool Check(Location locationToCheck) 
if (locationToCheck != myLocation) 
return false; 

else 

return true; 


The ChcdkO method jus-t dhcdks -the 
oppemcht’s lodaiioh aja'ms-t -the lo^aiio^ 
that was passed h> it a Locahor\ 
\rc-Pcv-c^dc. I-P they pomt bo 七 he 

object ihch he’s bccr> -Pour>d/ 


-► 


Wre not done yet-flip the pa^e! 
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exercise solution 



RciSe 

©PLyiiOH 

(cpHtiHv^P) 


Here’s all the code for the form. The only things 
that stay the same are the goHere—Click () 
and goThroughTheDoor—Click() 
methods. 

ttcvc av-c all -f ields m rov^l 

dlass. \i uses bo keep tva^k o+ 
lodatior^s, i\\t opponent and t\\t 
nuw'bcv' o-f »wovcs pUycv mdde. 


The Fo\rml to^sbruior d^reaics the ob.wU 

m/ j c thch \rcscts -the aa^e. 

I/Ve a Boo cah pa\rarwctc\r {o Kesci^meO 
V / so that it ohly displays i-fcs message whch you 
wm, ho 七 whch you +i\rs-t s-b\rt up the fv-ogv-am. 

public Forml() { 

工 nitializeComponent(); 

CreateObjects (); 

opponent = new Opponent(frontYard); 
ResetGame(false); 



int Moves; 

Location currentLocation; 

RoomWithDoor livingRoom; 
RoomWithHidingPlace diningRoom; 
RoomWithDoor kitchen; 

Room stairs; 

RoomWithHidingPlace hallway; 
RoomWithHidingPlace bathroom; 
RoomWithHidingPlace masterBedroom; 
RoomWithHidingPlace secondBedroom; 

OutsideWithDoor frontYard; 
OutsideWithDoor backYard; 
OutsideWithHidingPlace garden; 
OutsideWithHidingPlace driveway; 


V 


pponent opponent; 


private void MoveToANewLocation(Location newLocation) 
Moves++; 

currentLocation = newLocation; 

RedrawForm(); 




"Uc MoMtTohU^LotahoM sets 

Uafecm 铷⑼代如 aw 如 W 州 . 




private void RedrawForm() { 

exits . 工 terns • Clear (); 
for (int i = 0; i < currentLocation.Exits.Length; i++) 
exits. 工 terns.Add(currentLocation.Exits[i].Name); 
exits•Selectedlndex = 0; 

description.Text = currentLocation.Description + n \r\n(move 
if (currentLocation is 工 HidingPlace) { 

IHidingPlace hidingPlace = currentLocation 
check.Text = "Check " - 
check.Visible = true; 


Moves 


(^y^HidingPlace; 

hidingPlace.HidingPlaceName; 


h >^ccd the liidih^ pla^c 

but wc^vc ohly got the 
Cu\r\rCh*tL-od3*tioh y/liidli 

do^i have a HidihgPladc/Va 
piropc\rty. So wc use as 
"to ^Opy -the \rc-Pcv-Chdc to ah 
IttidihgPla^c vaH^ble. 




else 

check.Visible = false; 
if (currentLocation is 工 HasExteriorDoor) 
goThroughTheDoor.Visible = true; 

else 

goThroughTheDoor . Visible = false; Rcdlray/FoirmO populates 七 ― dombo bo>c |is*t, sets "tlic 


(add'mj -the ^urwbcv moves), ar\d ihch r^akes 
the buttons visible o\r invisible dcpchdmg cm y/hc*thcv- 
ov "thcv-c^s B door or "the \roorn has a hidm^ 
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Wow—you dould add c^*ti\rc y/'mj 。的 *to the house 
by add'm^ a double o( l'mcs| ThaVs v/hy well - 伙 dap 
classes a^d objects av-c v-cally useful. 


just 

sulatcd 


private void CreateObjects() { 

livingRoom = new RoomWithDoor("Living Room ", "an antique carpet ", 


inside the closet ", "an oak door with a brass handle"); 


diningRoom = new RoomWithHidingPlace("Dining Room ", 11 a crystal chandelier ", 

"in the tall armoire"); 

kitchen = new RoomWithDoor("Kitchen ", "stainless steel appliances ", 

"in the cabinet", "a screen door '，）； 

stairs = new Room("Stairs ", "a wooden bannister"); 

hallway = new RoomWithHidingPlace("Upstairs Hallway ", "a picture of a dog ", 
"in the closet"); 

bathroom = new RoomWithHidingPlace("Bathroom ", "a sink and a toilet ", 

"in the shower"); 

masterBedroom = new RoomWithHidingPlace("Master Bedroom ”， "a large bed", 

"under the bed"); 

secondBedroom = new RoomWithHidingPlace("Second Bedroom ”， "a small bed", 
"under the bed"); 


frontYard = new OutsideWithDoor("Front Yard ", false, "a heavy-looking oak door"); 
backYard = new OutsideWithDoor("Back Yard ", true, "a screen door"); 
garden = new OutsideWithHidingPlace("Garden ", false, "inside the shed"); 
driveway = new OutsideWithHidingPlace ("Driveway"true, "in the garage"); 


diningRoom.Exits = new Location[] { livingRoom, kitchen }; 
livingRoom.Exits = new Location[] { diningRoom, stairs }; 
kitchen.Exits = new Location[] { diningRoom }; 

stairs.Exits = new Location[] { livingRoom, hallway }; 

hallway.Exits = new Location[ ] { stairs, bathroom, masterBedroom, secondBedroom }; 

bathroom.Exits 二 new Location[] { hallway }; 

masterBedroom.Exits = new Location[] { hallway }; 
secondBedroom.Exits = new Location[] { hallway }; 

frontYard.Exits = new Location[] { backYard, garden, driveway }; 

backYard.Exits = new Location[] { frontYard, garden, driveway }; 

garden.Exits = new Location[] { backYard, frontYard }; 

driveway.Exits = new Location[] { backYard, frontYard }; 


livingRoom.DoorLocation = frontYard; 
frontYard.DoorLocation = livingRoom; 

kitchen.DoorLocation = backYard; 
backYard.DoorLocation = kitchen; 


The Y\t^i Cv-ca*tcObjcdtsO method 
dv-catcs all *thc objcd*U *to build 
house- (Vs a lot like old but i*t 
has a whole lot mov-c f lades -to 50. 

― ► Wre still not done-flip the pa^e! 


you are here ► 
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exercise solution 



§PLjitlOH 




ttcv-c^s *thc rest o( -the Code (or the -fov-m. The ^ottcv-c a^d 
joThv-oughThcPoov button cvc^*t handlers a\rc idc^-tidal b> 
the OY\ts \y\ *thc -Piv-s*t fav-*b o-P -this c>cc\rdisc, so -Piif badk a -few 
pays *to see them. 


private void ResetGame(bool displayMessage) { 
if (displayMessage) { 

MessageBox. Show ("You found me in " + Moves + " moves !’，）； 
IHidingPlace foundLocation = currentLocationIHidingPlace; 
description.Text = "You found your opponent in " + Moves 


moves! He was hiding 


foundLocation.HidingPlaceName 



Moves = 0; 

hide.Visible = true; 
goHere.Visible = false; 
check.Visible = false; 
goThroughTheDoor.Visible 
exits.Visible = false; 


false 


The Rcsct^amcO method \rcsc-b -the H 
displays the -fi^l message, makes all ihc 
except ihe “Wide /、 吡 ^visible. 

We v/a^i -to di 


Wc waht to display the of ihe 
hidmg but Cu\r\rer\iLo^aiion is 


a 


us 


private void check_Click(object sender, EventArgs e) 
Moves++; 

if (opponent.Check(currentLocation) 

ResetGame(true); 

else 

RedrawForm(); 



private void hide_Click(obj ect sender, EventArgs e) 
hide.Visible = false; 

for (int i = 1; i <= 10; i++) { 

opponent.Move(); 
description.Text = i + 

Application.DoEvents(); 

System.Threading.Thread.Sleep(200); 



description.Text = "Ready or not, here 工 come 
Application.DoEvents(); 

System.Threading.Thread.Sleep(500); 

goHere.Visible 二 true; 
exits.Visible = true; 

MoveToANewLocation(livingRoom); 



。匕 at— so it docs^i a,VC 

addess -to the ttidihgPladc/Varnc -field. 
Luckily, wc use the as keywovd *to 
do^uasiii -to ah (HidihgPUc v-c-Pcv-chdc 

that pomts -to -the sar^e object 


W\\cy\ you dick *thc t)ntck 
button, i*t dhcdks y/hc*thc\r o\r 
^o*t *thc is hid'mj m 

the v-oom. |-f he is, i*t 

\rcsc*b *thc jamc. |-f ^o*t, it 

v-edv-aws *thc -ro\rm (*to update 
the J^umbcV" moves). 

Rcmcrhbc\r DoEvchtsO FbshyTVi 叫 

ih Chapin Z? IVi^oul ii the text box 

^ OCSh ^ ^c-p^csli itscl-P ahd the p\roav-am looks 
Wch. J 


TWide but*ton is i\\t one stavb 
aamc. T\\t -first \i dots »s make »tscU- 
mvis'ible. T)ntv\ it founts *to 10 and *WU 
oYYo^i move. PmallY, ••七 ^akes i^kwsi 
bu*t*tor\ 3r\d *tV^C tombo bo% visible, 3r\d 七 
starts -tv^c flayer m i\\t \W\^ 

The M ovcToAhlcY/Lo6sbor\() 乙 alls 

Rcdv-av/Fo\rmO. 
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oopcross 



Across 

3. What an abstract method doesn't have 

4. C# doesn't allow_inheritance 

6. When you pass a subclass to a method that expects its 
base class, you're using this OOP principle 
8. The OOP principle where you hide private data and only 
expose those methods and fields that other classes need 
access to 

10. One of the four principles of OOP that you implement using 
the colon operator 

14. Every method in an interface is automatically_ 

15. If your class implements an interface that_ 

from another interface, then you need to implement all of its 
members, too 

17. An access modifier that's not valid for anything inside an 
interface 

18. Object_Programming means creating programs 

that combine your data and code together into classes and 
objects 


Down 

1. When you move common methods from specific classes to 
a more general class that they all inherit from, you're using this 
OOP principle 

2. If a class that implements an interface doesn't implement all 
of its methods, getters, and setters, then the project won't 


5. Everything in an interface is automatically_ 

7. An abstract class can include both abstract and 

_methods 

9. You can't_an abstract class 

11. A class that implements this must include all of the methods, 
getters, and setters that it defines 

12. What you do with an interface 

13. The is keyword returns true if an_implements 

an interface 

16. An interface can't technically include a_ ， but it 

can define getters and setters that look just like one from the 
outside 


you are here ► 
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exercise solutions 



Paa] Puzzjc §a]utian fr 娜 pcige 32^ 


Your job is to take code snippets from the pool and place them 
into the blank lines in the code and output. You may use the 
same snippet more than once, and you won’t need to use all the 
snippets. Your goa/ is to make a set of classes that will compile 
and run and produce the output listed, n , , . 

s the dass ca\\s the dcsWW 
m P.dasso, whidh \i ihhcHts li passes VUW 

… to th, whidh gets sWd m the 

pV*opC\rty. 


Nose 


interface 
int EarQ ； 

string Face { get; 


class Acts : Picasso { 

public Acts() : base("Acts") 

public override int Ear() 
return 5; 


abstract class Picasso : Nose 
public virtual int Ear() 

{ 

return 7; 

} 

public Picasso(string face) 


this, face 


face 


public virtual string Face 

get { return face ； } 


string face; 



Pv-o\>cv*t>cs 
apfC 3 V" nr\ 

tlass! It's easier 

-to v-edd Y ouV " ^ 0< ^ c 
七 a 七从 e *t°?> 

ku-t 

valid *to Kavc i\\t 
-fate pvopevt/ a 七 
七 he bottom d 七 ^ 
pitasso tlass. 


class Of76 : Clowns { 

public override string Face 
T get { return "Of76"; } 


public static void Main(string[] args) { 

string result =""; 

Nose [ ] i = new Nose[3]; 

i[0] = new Acts(); 

i[1] = new Clowns(); 

i [2 ] = new Of 76(); 

for (int x = 0; x < 3; x++) { 

result +=( .•MrEarQ+ ” ” 

+ i[x].Face ) + n \n 


class Clowns : Picasso { 

public Clowns() : base("Clowns") 



Output 


Console.WriteLine(result); 
Console.ReadKey(); 




is 3 get auessofr that 
|rc-tuirhS the value ihc 

P^pcvty. Both them 
⑽ defrned ih Picasso a^d 
ih-to the subdass«. 
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OOPcroSS Solution 
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8 enums and collections 



When it rains, it pours. 

In the real world, you don’t get to handle your data in tiny little bits and 
pieces. No, your data’s going to come at you in loads, piles, and bunches. 
You’ll need some pretty powerful tools to organize all of it, and that’s where 
collections come in. They let you store, sort, and manage all the data that 
your programs need to pore through. That way, you can think about writing 
programs to work with your data, and let the collections worry about keeping 
track of it for you. 


this is a new chapter 












nurse sharks and carpenter ants 


Strings dowt always work for 
storing categories of data 

Suppose you have several worker bees, all represented by 
Worker classes. How would you write a constructor that took 
a job as a parameter? If you use a string for the job name, you 
might end up with code that looks like this: 


Ouv kcc so^-tv/a^rc kept 

tacM y/ovWs job — a sV ， Jkr 
PaVol^ or Collet . 



Ouv Code y/ould alloy/ values *to be passed 

•m a dor\s*tvu^*tov- cver^ or\ly 

sufforts Stm^ Pa*W, Uttiar Collet 3r^d 
o-t^cv- jobs i\\ai a bcc docs. 、 


Worker 

Worker 

Worker 


buzz = 
clover 
gladys 


new Worker("Attorney General") 
=new Worker ( Tl Dog Walker ”）； 

=new Worker ("Newscaster 11 ); 


: ak f ， : 。： b A:ii u it h ， bs ^ 





You could probably add code to the Worker constructor to check each 
string and make sure it’s a valid bee job. However, if you add new jobs 
that bees can do, you’ve got to change this code and recompile the 
Worker class. That’s a pretty short-sighted solution. What if you have 
other classes that need to check for the types of worker bees they can be? 
Now you’ve got to duplicate code, and that’s a bad path to go down. 

What we need is a way to say, “Hey, there are only certain values that are 
allowed here.” We need to enumerate the values that are OK to use. 
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enums and collections 


Enums let you work with a set 
of valid values 


The 'ms'idc *tV>c bv*3dkc*ts is 

dalled c^umcv-atov lis 七， by\A 


An enum is a data type that only allows certain values for that piece 
of data. So we could define an enum called Job, and define the 


allowed jobs: 



TV、s 






eadii rtem is a 灼 cy>umcva*toy. TV>c 
whole *toytKcv is Edited 

Cy>umCV-a*tio^. 


enum Job 



TV^c last c^mcva-fcov- 
docs^t V^avc -to t^A 
v/i-bV^ a domma, bu-b 

m3kcs 

cas'icv *to veavva 呼 
七 us'm^ a^d 




NectarCollector r 
StingPatrol r 
HiveMaintenance r 
BabyBeeTutoring r 
EggCare 沒 ____ 


^ ihese is , 

A^y ^ be 

3s , J obs 


But most fcoflc jus 七 
ddll 'them Churns. 



Qcya 


rate catV\ vaWc 


HoneyManuf acturing r ^ a to_a ， 


3 ir\di 


如 ^olc a 

“rVf bv-atc. 


Now, you can reference these with types like this: 


This is -the 
name o-P the 

CK>urw. 




ihc v^luc 
J OU *Pv-orh 
仏 C Chunr>. 


Worker nanny = new Worker(Job.EggCare); 


: 以3 ^ : 

切 ? 


vb 


But you can’t just make up a new value for the enum! If you do, 
the program won’t compile. 


private void buttonl Click(object sender EventArgs e) 


Worker buzz = new Worker(Job.AttorneyGeneral); 



Job' does not contain a definition for 
AttorneyGeneral' 


Jfv-om tV^c 
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names are better than numbers 


Enums let you represent numbers with names 


Sometimes it’s easier to work with numbers if you have names for them. You can assign 
numbers to the values in an enum and use the names to refer to them. That way, you don’t 
have a bunch of unexplained numbers floating around in your code. Here’s an enum to keep 
track of the scores for tricks at a dog competition: 


enum TrickScore { 


TV^csc (W 七 
"to kc m 

a” 

you 

wultflc 灼 awes 

-to W\t sa^c 


Sit = 7, 

Beg = 25, 
RollOver = 50, 
Fetch = 10, 
ComeHere = 5, 
Speak = 30, 



You can cast an i 
to an enum, and 
you can cast an 
(int-based) enum 
back to an int. 


Jppl 丫 a i heh 

^ds 4,. 七一 e 


Some use a di-f-Pcv-c^-t type, 
like byte ov* lor>j—like ihc o^c ai 

"the bottom of ihis page — a 灼 d you 

das-t "those ba^k -fco -theiv- "type. 


Here’s an excerpt from a method that uses the 
TrickScore enum by casting it to and from an int. 

tint)' 



int value = (^int)^rickScore. Fetch * 3 
MessageBox.Show(value.ToString()); 
TrickScore score = (TrickScore)value; 
MessageBox.Show(score.ToStringO); 


TV (m*t) das-t tells i\\t tornpilcv *to *tuv^ *t^is m*to i\\t 
^bev- \i w ⑽ Is. So sm “ Tr\ck^torMcM V^as a 
value \O t (m 七 ) tums rt m*to 七 ^ 

•m 七 value 10 . Sihdc Fe-Uh has a value o-f 

10, this S-ta-tcmCht sets the 

v^luc io 1>0. 


e 


You can cast the enum as a number and do calculations with it, or you can use the 
ToString () method to treat the name as a string. If you don’t assign any number 
to a name, the items in the list will be given values by default. The first item will be 
assigned a 0 value, the second a 1 ， etc. 

But what happens if you want to use really big numbers for one of the enumerators? 
The default type for the numbers in an enum is int, so you’ll need to specify the type 
you need using the : operator, like this: 


>u ^ m-b \x> 

a Tv'^kSdovc. vaWc ' 
cr al ^ ^ stort yts set 

Tr»6kS6oyrc.Sfcak. ^ ^ 

V ou 6all 

vcWs W S〆’. 


enum TrickScore : long { 

Sit = l r 

Beg = 2500000000025 

} 


"This tells -the 匕 ompilev* *to -ived-i 
values i h the TVuikS^o^ Chum as 
lohjs, hot iivts. 


If you tried to compile this code without specifying long as the type, you’d get this message: 

_Cannot implicitly convert type * long * to 'int * ._ 
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Use what you’ve learned about enums to build a class that holds a playing card. 


Suit 

Value 


O C1ZBATB A NB\aJ PROJECT ANt> At>t> A CA12t> CUASS^ 


Name 


You’ll need two public properties: Suit (which will be Spades, Clubs, Diamonds, 
or Hearts) and Value (Ace, Two, Three...Ten, Jack, Queen, King). And you’ll 
need a read-only property, Name (Ace of Spades, Five of Diamonds). 


Card 


O use TVJO BMUMS TO V>BFINB THB SUITS ANt> VAUUBS^ — 

Use the familiar Add^Glass feature in the IDE to add them, replacing the word class 
with enum in the newly added files. Make sure that ( int) Suits . Spades is equal 
to 0, followed by Clubs (equal to 1), Diamonds (2), and Hearts (3). Make the values 
equal to their face values: ( int) Values . Ace should equal 1, Two should be 2, Three 
should be 3, etc. Jack should equal 1 1 ， Queen should be 12, and King should be 13. 


© 


o 


At>t> A PJZOPBRT/ FOIZ THB SJAM5 OF THB CA12t>^ 

Name should be a read-only property. The get accessor should return a string that describes the card. 
This code will run in a form that calls the Name property from the card class and displays it: 

To make v/ovk, Y ou,r C av ^ 

tlass y/»ll 从 cd a t 撕士 
如七 takes *tv/o \>av-amc*tcv-s. 


Card card = new Card(Suits•Spades, Values.Ace) 
string cardName = card.Name; 

The value of cardName should be Ace of Spades. 


At>t> A PO 訊 BUTTON THAT POPS UP THB NAMB OF A 12ANt>^>M CA12t> 

You can get your program to create a card with a random suit and value by casting a random number 
between 0 and 3 as a Suits and another random number between 1 and 13 as a Values. To do this, 
you can take advantage of a feature of the built-in Random class that gives it three different ways to call 

f its Next () method: 

Whch you've got move 


ihah ohc way -to £d|| 
a method, i-t ; s called 

ovcv-loacTmg. /VJov-c 

that 


Oh 


Random random = new Random(); 
int numberBetween0and3 = random.Next(4); 
int numberBetweenlandl3 = random.Next(1, 14) ; 
int anyRandomlnteger = random.Next(); y 

This tells R^doim -to a value a-t leas 七丨 but uhdev 

Dumb Questions 


I 午 . 



Hold on a second. When I was typing in that code, I 
noticed that an IntelliSense window popped up that said 
something about "3 of 3” when I used that Random.Next () 
method. What was that about? 

A! What you saw was a method that was overloaded. When a 
class has a method that you can call more than one way, it’s called 
overloading. When you’re using a class with an overloaded method, 
the IDE lets you know all of the options that you have. In this case, 
the Random class has three possible Next () methods. As 


soon as you type “random.Next (” into the code window, the IDE pops 
up its IntelliSense box that shows the parameters for the different 
overloaded methods. The up and down arrows next to the “3 of 3” let 
you scroll between them. That’s really useful when you’re dealing 
with a method that has dozens of overloaded definitions. So when 
you’re doing it, make sure you choose the right overloaded Next () 
method! But don’t worry too much now—we’ll talk a lot about 
overloading later on in the chapter. 

random, Me>ct(| 

* 3 of 3 f nt Random.Mext(int minValuej int tnajcValue) 

Returns a random number within a specified range, 


mmValue: The infiusii/e iower bound of the rondom number returned 
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arrays...who needs ’em? 



内 jRciSe 
§PLjitlOH 


A deck of cards is a great example of where limiting values is important. Nobody 
wants to turn over their cards and be faced with a Joker of Clubs, or a 13 of 
Hearts. Here’s how we wrote the Card class. 


enum Suits - 
Spades, 
Clubs , 
Diamonds , 
Hearts 



peh you do^i spc^i-Py values, -the 
+|«七 item ih the lis-fc is c^ual io O, 
七 k sedohd is I, ihe iWird is 1, tit. 


enum Values 
Ace = 1 , 
Two = 2, 
Three = 
Four = 4 



Values .bo I- 


sc*t value 


Five — 5 , 
Six = 6 , 


Seven = 7 , 
Eight = 8 , 
Nine — 9, 


Ten = 10, 
Jack = 11, 
Queen — 12 
King = 13 


class Card 

public/ Suits 



CaYd has a 
^ of iy ?c 

a Value 

P^y o-P iy?c ^ 


get; set; 


publicM^lusa^Value { get; set; 


We chose the names Suits 
and Values for the enums, 
while the properties in the Card 
class that use those enums 
for types are called Suit and 
Value. What do you think 
about these names? Look at 
the names of other enums that 
you’ll see throughout the book. 
Would Suit and Value make 
better names for these enums? 


public Card(Suits suit. Values value) 
this.Suit = suit; 
this.Value = value; 



ac-t aucssor for *tV^c Name \>v-o\>cv*t^ 
^ take adv/a 山 y J 仏 c ” 扣 : 
To£ 七— (） its 咖 c 
towted *to a sbr\^ 


public string Name - 

get { return Value . ToString () + ▼' 

} 厂 Wtrts Code (or bu*tW 从 at \>ofs 

"tiiC o-f 3 V 3 ir\dom t 3 V*d* 


of " + Suit.ToString (); 


} *+C\rcs wKc\r C wc use the 

^loaded Ra^do^H^iO 

^cihod -to schc^a-tc a 
/ Mhdom hurhbc\r -that wc 
"to the 




Random random = new Random(); 

private void buttonl_Click(object sender, EventArgs e) { 

Card card = new Card((Suits)random.Next (4) r (Values)random•Next(1, 14)); 
MessageBox.Show(card.Name); 


Churh. 
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Wc could use an array to create a deck of cards 

What if you want to create a class to represent a deck of cards? It would need a 
way to keep track of every card in the deck, and it’d need to know what order they 
were in. A Card array would do the trick — the top card in the deck would be at 
value 0, the next card at value 1 ， etc. Here’s a starting point — a Deck that starts 
out with a full deck of 52 cards. 


class Deck { 

private Card[] cards = { 

new Card(Suits.Spades, Values.Ace) 
new Card(Suits.Spades, Values.Two) 
new Card(Suits.Spades, Values.Three ), 

"... 

new Card(Suits.Diamonds , Values.Queen ), 
new Card(Suits.Diamonds , Values.King ), 



Wou, ^ ^-tihuc all ih c 

ihe de.k. 
s Jft ^bbircvia-tcd 

io save sp^c. 


public void PrintCards() { 

for (int i = 0; i < cards.Length; i++) 
Console.WriteLine(cards[i].Name()) 


..but what if you wanted to do more? 

Think of everything you might need to do with a deck of cards, though. If 
you’re playing a card game, you routinely need to change the order of the 
cards, and add and remove cards from the deck. You just can’t do that with 
an array very easily. 


How would you add a Shuffle () method to the Deck class that 
rearranges the cards in random order? What about a method to deal the 
first card off the top of the deck? How would you add a card to the deck? 
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fine collectibles 


Arrays arc hard to work with 


An array is fine for storing a fixed list of values or references. But once you need 
to move array elements around, or add more elements than the array can hold, 
things start to get a little sticky. 



Every array has a length, and you need to know the length to work with it. You could use 
null references to keep some array elements empty: 






lr\d 



⑽ 3, 午 a 


^y\d 




^^rds. 


TW\s a^ay ^ a Lc^ of 


0 


1 


十 




❺ 


❺ 


You’d need to keep track of how many cards are being held. So you’d need an int field, 
which we could call topCard, that would hold the index of the last card in the array. So 
our three-card array would have a Length of 7, but we’d set topCard equal to 3. 

II add 3 "topCav-d -field *fco ket 




tira^k o-f how r^hy ^av-ds av-c ih the 

Ahy ihdex above ioyCard has a 
hull Ca\rd \rc-rc\rchdc. 


inoioini 


0 


1 


十 




6 hcrcs atWIv A^7 .Rcs\«0 
mci^od ku'»l*t m*to i\\t UtT 
Fvamcv/o^rk docs 七 ^ 七 . 

But now things get complicated. It’s easy enough to add a Peek () method that just returns a 
reference to the top card — so you can peek at the top of the deck. But what if you want to add 
a card? If topCard is less than the array’s Length, you can just put your card in the array at 
that index and add 1 to topCard. But if the array’s full, you’ll need to create a new, bigger array 
and copy the existing cards to it. Removing a card is easy enough — but after you subtract 1 from 
topCard, you’ll need to make sure to set the removed card’s array index back to null. And what 
if you need to remove a card from the middle of the list? If you remove card 4, you’ll need to 
move card 5 back to replace it, and then move 6 back, then 7 back.. .wow, what a mess! 



358 


Chapter 8 










enums and collections 


Lists make it easy to store collections of...awythiwg 


The .NET Framework has a bunch of collection classes that handle all of those 
nasty issues that come up when you add and remove array elements. The most 
common sort of collection is a List<T>. Once you create a List<T> object, it’s 
easy to add an item, remove an item from any location in the list, peek at an item, 
and even move an item from one place in the list to another. Here’s how a list works: 


o 


First you create a new instance of List<T>. 

Every array has a type — you don’t just have an array, you have an int array, a Card 
array, etc. Lists are the same way. You need to specify the type of object or value that the 
list will hold by putting it in angle brackets <> when you use the new keyword to create it. 


List<Card> cards = new List<Card>(); 



y _ You <Cavd> you 

seated list , SO v\o^i 七 his 
list or\ly holds *to 

Cav-d objects. 



Wlc’ll sometimes 

leave <T> o-f-f 

because *i*b 
make book a 

little iiavd *to v-cad. 
you see 

*tWk Lis*t<T>| 

l 


❺ 


The <T> at the end 
of List<T> means 
it’s generic. 

The T gets replaced with a type — so 
List<int> just means a List of 
ints.You’ll get plenty of practice with 
generics over the next few pages. 


Now you can add to your List<T>. 

Once you’ve got a List<T> object, you can add as many items to it as you want (as long as they’re 
iVhidh polymorphic with whatever type you specified when you created your new List<T>). 

"bicy /’ 丨 cards • Add (new Card (Suits • Diamonds, Values • King)); 

assignable cards .Add (new Card (Suits • Clubs, Values . Three)) 

to the typc ： 

. "tcv-fadcs cards .Add (new Card (Suits • Hearts, Values .Ace)); 

abs 七 vad 七 classes, 


base classes, tit- 


You CBy\ add as many 
dav~ds as you *to 
Lis 七 - jus 七乙 all i*b AddO 
mc*thod- I*t1l make suve 
its ^o*t Cnou# u slo*U 
-Pov the items. I-P I*t 
shirts *to vu^ ou*t> i*t1l 
au*toma 七 idally v-csiz-c *i*bcl-p. 



King of 
►iamonds. 


ob\^ 


h list keeps its dements 

like ah 

o-f Diamonds 
st, Z o( Clubs 
is second, av\d hu o-f 
ficav-ts is 


T\ IX 

•m o\rdc\r, jus*t 

針 ay. o\ 

is -Pi^s-t, Z of 
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wow, what an improvement! 


Lists arc more flexible thaw arrays 


The List class is built into the .NET Framework, and it lets you do a lot of 
things with objects that you can’t do with a plain old array. Check out some 
of the things you can do with a List<T>. 



You can make one. 

List<Egg> myCarton = new List<Egg>(); 


義 SS2S " 





Add something to it. 

Egg x = new Egg(); 
myCarton.Add(x); 





Kon, Ust -to v^old 

七 U 奶 object- 




x 


Add something else to it. 

Egg y = new Egg (); 
myCarton.Add(y); 


Find out how many things are in it. 

int theSize = myCarton.Count; 



CX P ahds ^9^^ "to hold 

ihe sc ^ 0hd E99 object 

y 



Find out if it has something in particular in it. 

bool isln = myCarton.Contains (x); 




you w 


o Figure out where that thing is. 

int idx = myCarton • 工 ndexOf(y 


The ihdex. (ov x. y/ould be O d^d the 
_ mdoc -Pov- y would be I- 



Take something out of it. 

myCarton.Remove(y); 
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W\\tY\ y/c verwoved Ic-ft only % m 
Lis 七 , so rt sWar^k! MA eventually 
rt y/ill yt £>ollcd*tcd- 
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c^terpen your pencil 


Fill in the rest of the table below by looking at the List code on 
P the left and putting in what you think the code might be if it were 
Heve ave d -row -rvom middle ok a using a regular array instead. We don't expect you to get all of 
pvo^vam. /\ssume avc 311II them exactly right, so just make your best guess, 

m oyAcv, oy\c 
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one size fits all 


c^^rpen 


your pencil 
Solution 


Your job was to fill in the rest of the table by looking at the List code 
on the left and putting in what you think the code might be if it were 
using a regular array instead. 


List Regular array 


List<String> myList = 

new List <String>(); 

String[] myList = new String[2]; 



String a = "Yay!" 

String a = "Yay!"; 

myList.Add(a); 

myLis*tCO] — a; 



String b = "Bummer"; 

String b = "Bummer"; 

myList.Add(b); 

myLis*tCI] — b ； 



int theSize = myList.Count; 

’m 七 *thcSizjC 二 myList Length; 



Guy o = guys[1]; 

与 uy o 二 juysCn ； 



bool isln = myList.Contains(b); 

bool is|^ =• -false ； 

•fov (m 七 •• 二 0; i < myList 
i++) { 

i*f (b 二二 myLis*tCi3) { 
is|^ — *bruc; 

} 

} 


Lists are objects that use methods just like every 
other class you’ve used so far. You can see the list 
of methods available from within the IDE just by 
typing a . next to the List name, and you pass 
parameters to them just the same as you would for 
a class you created yourself. 


With arrays you’re a lot more limited. You need 
to set the size of the array when you create it, and 
any logic that’ll need to be performed on it will 
need to be written on your own. 

The NET Fv-amcwovk does have By\ 

Av-v-ay dass, y/hidh rv>akes some o( -these 
th'mjs a little casicv -to do, bui wcVc 

ot\ List objects because 
thcyVc a loi casiev -to use. 
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Lists shrink and grow dynamically 

The great thing about a List is that you don’t need to know how long it’ll be when you 
create it. A List automatically grows and shrinks to fit its contents. Here’s an example 
of a few of the methods that make working with Lists a lot easier than arrays. Create 
a new Console Application and add this code to the Main () method. It won 7 t print 
anything — use the debugger to step through the code and see what’s going on. 



tMs ! 命 


^ 3 dc^laHhg a Lis-t 

" ，,cd 


List<Shoe> shoeCloset = new List<Shoe>() 


shoeCloset.Add(new Shoe() 

{ Style = Style•Sneakers, Color 
shoeCloset.Add(new Shoe() 

{ Style = Style.Clogs , Color =' 
shoeCloset.Add(new Shoe() 

{ Style = Style•Wingtips, Color 
shoeCloset.Add(new Shoe() 

{ Style = Style.Loafers , Color : 
shoeCloset.Add(new Shoe() 

{ Style = Style.Loafers , Color : 
shoeCloset.Add(new Shoe() 

{ Style = Style•Sneakers, Color 

int numberOfShoes = shoeCloset.Count; 
(fpreach (Shoe shoe in shoeClose 

shoe.Style = Style.Flipflops; 
shoe.Color = "Orange"; 


You use a new msidc 

Lis*t.Add() method- 


'Black" }) 


'Brown" }) 


'Black" }) 


'White" }) 


n 


Red" }); 

"Green" }); 

This vctuvhs the 
hurwbcV" 0-(* 
SKoc objects ih 
tKc List 



The RcrwovcO method will 
v-emove -the obje^-t by i-ts 

RcrwovcAiO docs 
rt by mdex ^umbev*. 

shoeCloset.RemoveAt(4); 

Shoe thirdShoe = shoeCloset[2]; 
Shoe secondShoe = shoeCloset[1] 
shoeCloset.Clear(); 


This loop Joes 

-thv-oujh o-f 

shoes m the dlosct- 


丁 he ClcavO method 
Irc^ovcs all Jc the 
。―也 ih a List 


lAfe saved 
{p 七 y/o sV^ocs 
Y/C £.lc3V"cd *tV^c list Wc 
；added one batk, bu*t 


shoeCloset.Add(thirdShoe) 
if (shoeCloset. Contains (secondShoe) ci；i 1,ssm 9 

Console.WriteLine("That A s surprising .")； 

•This Imc v/ill y^cvcv" \ru^, bedduse Co^*t3ms0 W\W -false- Wlc 

only added -thiv-dShoc 'm-fco He dlcav-cd lis-t, scdo^dShoc- 



foreach is a special kind of 
loop for Lists. It will execute 
a statement for each object in 
the List- This loop creates an 
identifier called shoe. As the 
loop goes through the items, 
it sets shoe equal to the first 
item in the list, then the 
second, then the third, until 
the loop is done. 

-fov-catK loops v/ov-k oy\ arrays, b>o! U 

訊 tKcy y/ork oh a^y tollctW 

ttcvc^s *thc Shoe tlass wcVc usm^ 

3y\d S*tvlc "i*t uses. 

^ 


class Shoe { 

public Style Style; 
public string Color; 


enum Style { 
Sneakers , 
Loafers , 
Sandals, 
Flipflops, 
Wingtips , 
Clogs , 
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membership has its privileges 


frcwcrics caw store awy^type 


^^BULLET POINTS - 

■ List is a class in the .NET Framework. 


You’ve already seen that a List can store strings or Shoes. 
You could also make Lists of integers or any other object 
you can create. That makes a List a generic collection. 
When you create a new List object, you tie it to a specific 
type: you can have a List of ints, or strings, or Shoe objects. 
That makes working with Lists easy — once you’ve created 
your list, you always know the type of data that’s inside it. 


A List resizes dynamically to whatever 
size is needed. It's got a certain capacity— 
once you add enough data to the list, it’ll grow 
to accommodate it. 

To put something into a List, use Add (). 
To remove something from a List, use 


This doesn't ad-tually me 扣 you add lc*t*tcv- T. Its a 

-that you II sec v/hc^cvcv- a dass ov* wov-ks 

v/ith all types. The <T> pav-t you 乙扣 pu 七 a type ’m 
•theve, like Lis-t<£hoc>, whith limrts rts mcmbcv-s -to *typc- 


List<T> name = new Li 

L—^ 叫 ( fta^avs 
_) 一 7 vesWwe. So ^e 7 do a^a Y 

一七 vJ — 饪 a 一脚-°… 


s 4 T > 


0 


Remove () ■ 

■ You can remove objects using their index 
number using RemoveAt (). 

■ You declare the type of the List using a 
type argument, which is a type name in 
angle brackets. Example: List<Frog> 
means the List will be able to hold only 
objects of type Frog. 

■ To find out where something is (and if it is) in 
a List, use indexOf (). 


The .NET Framework comes with some generic 
interfaces that let the collections you’re building work 
with any and all types. The List class implement those 
interfaces, and that’s why you could create a L i s t of 
integers and work with it in pretty much the same way 
that you would work with a List of Shoe objects. 

Check it out for yourself. Type the word List into 
the IDE, and then right-click on it and select Go To 
Definition. That will take you to the declaration for the 
List class. It implements a few interfaces: 


■ To get the number of elements in a List, 
use the Count property. 

■ You can use the Contains () method to 
find out if a particular object is in a List. 

■ f oreach is a special kind of loop that will 
iterate through all of the elements in a List 
and execute code on it. The syntax for a 

f oreach loop is f oreach (string s in 
StringList). You don’t have to tell the 
f oreach loop to increment by one; it will go 
through the entire List all on its own. 
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Watch it! 


You can’t modify a 
collection while 
you’re using foreach 
to iterate through it! 

If you do, it will cause an error. Luckily, 
you can always make a copy of it. 
Every IEnumerable has a ToList () 
method that you can use to make a 
copy of it to safely iterate through. 


















enums and collections 


/ (^$\ Code Magnets 


Can you reconstruct the code snippets to make 
a working Windows Form that will pop up the 
message box below when you click a button? 



public void printL (List<string> a){ 



private void buttonl_Click(object sender, 
EventArgs e){ 


if (a. Contains("two")) 

a.Add(twopointtwo); 

} 

a.Add(zilch )； 

a. Add (first )； 
a. Add(second); 
a. Add(third )； 


LU 


string result = 

if (a.Contains("three")){ 
a.Add("four "); 




result 


‘ n ” + element 




lf ( a • 工 ndex0 f ( n four n ) != 4 ) 

a •Add(fourth )； 




string zilch 
string first = 
string second 
string third 
string fourth 
string twopointtwo 





2.2 
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lists have types 



Code Magnets Solution 


Remember how we talked about using 
intuitive names back in Chapter 3? Well, 
that may make for good code, but it makes 
these puzzles way too easy. Just don’t use 
cryptic names like printLQ in real life! 


private void buttonl Click(object sender, EventArgs e) 


D 


zero 

one 

three 

four 

4 .Z 


OK 


RemoveA*tO \TCmoVCS 

dement 

•mde% 养 2 •— wWiA is 

七 Wd element 

■bV^c list 


丁 he *Po\rC 3 £.li iooy 

though all the 
clc^Chts ih the list 
ahd f\rihts them. 


List<string> a. = new List<string> () ’ 


string zilch : 
string first = 
string second 
string third 
string 




2.2 


a.Add(zilch )； 
a.Add (first); 
a. Add(second); 
a.Add(third )； 



if (a.Contains("three")) 
a.Add("four"); 


C^h you -Piguv-c 
oui why U Z.Z W 

3 士 added 
io the list, eveh 
"though i^s 

dcda\rcd heve? 


a - RemoveAt (2) 


if (a•IndexOf ( n four n ) != 4) { 

a•Add(fourth); 



if (a. Contains( M two n )) 

a.Add(twopointtwo )； 

££i?tL(a )； 


The method uses d 

-Pov-cadV> loop *bo 50 七 hv。— a 
lis*t of s*tv'm^s, add cadh of 
•them *to oY\t b*i^ and 

show *i*t m 3 message bo%. 


public void printL 

(List<string> a){ \ 

-- - 1 

[string resulpT^ 

»n! 1 




foreach (string element 
result += * 


m a) 

n ’’ + element; 


MessageBox•Show(result) 
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enums and collections 


So why would I ever use an enum 
instead of a List? Don’t they solve the 
same problem? 

A! Enums are a little different than 
Lists. First and foremost, enums are 
types, while Lists are objects. 


You can think of enums as a handy way to 
store lists of constants so you can refer 
to them by name. They’re great for keeping 
your code readable and making sure that 
you are always using the right variable 
names to access values that you use really 
frequently. 

A List can store just about anything. 

Since it’s a list of objects, each element in a 
list can have its own methods and properties 
Enums, on the other hand, have to be 
assigned one of the value types in C# (like 
the ones on the first page of Chapter 4). So 
you can’t store reference variables in them. 

Enums can’t dynamically change their size 
either. They can’t implement interfaces or 
have methods, and you’ll have to cast them 
to another type to store a value from an 
enum in another variable. Add all of that up 
and you’ve got some pretty big differences 
between the two ways of storing data. But 
both are really useful in their own right. 


OK, it sounds like Lists are 
pretty powerful. So why would I ever want 
to use an array? 

A! If you know that you have a fixed 
number of items to work with, or if you want 



Av*v-ays also -take uf less memovy 
a 灼 d CPU -time -Pov- youv yvoyams, 
but 七 ha 七 or^ly addouy>*b +ov a *t*my 
boost |-f you have *to 
do {\\t same 少 say, millions o( 
•times a you *to 

use by\ avvay 的 。七 a list Bu 七』 

youv* fvobvarw is slowly, its 

unlikely -pvorr 

lists *to av-vays will f i 乂 fvoblcm. 


tJiereiar 

Dumb 


e no o 

Questi 9 ns 

a fixed sequence of values with a fixed 
length, then an array is perfect. Luckily, you 
can easily convert any list to an array using 
the ToArray () method...and you can 
convert an array to a list using one of the 
overloaded constructors for the List<T> 
object. 

I don’t get the name “generic.” Why 
is it called a generic collection? Why isn’t 
an array generic? 

A generic collection is a collection 
object (or a built-in object that lets you store 
and manage a bunch of other objects) that’s 
been set up to store only one type (or more 
than one type, which you’ll see in a minute). 

OK，that explains the “collection” 
part. But what makes it “generic ”？ 

A! Supermarkets used to carry generic 
items that were packaged in big white 
packages with black type that just said the 
name of what was inside (“Potato Chips,” 
“Cola，” “Soap，” etc.). The generic brand was 
all about what was inside the bag, and not 
about how it was displayed. 

The same thing happens with generic data 
types. Your List<T> will work exactly the 
same with whatever happens to be inside 
it. A list of Shoe objects, Card objects, 
ints, longs, or even other lists will still act at 
the container level. So you can always add, 
remove, insert, etc., no matter what’s inside 
the list itself. 


Can I have a list that doesn’t have 
a type? 

No. Every list—in fact, every generic 
collection (and you'll learn about the other 
generic collections in just a minute)—must 
have a type connected to it. C# does have 
nongeneric lists called ArrayLists 
that can store any kind of object. If you 
want to use an ArrayList, you 
need to include a using System. 
Collections ; line in your code. But 
you really shouldn’t ever need to do this, 
because a List<ob j ect> will work 
just fine! 

Wken you create 
a new List object ， 
you always supply 
a type — tliat tells 
C 井 wkat type ol 

data it’U store* A 
list can store a 
value t^pe (like int ， 
tool，or decimal) or 


w v—/ 呼 c J a class* 

a 

ur\s a {^dy\dc L-is*b ^3^ s*tov*c 
OY\t 七 Yfe, 七 he List dass m 

(xe^ev'dl wovks W\{\\ type- 

WUk <T>is all about IVs ^ ^ U 

y/^ole is (\Mr\C *to 破 k 4 ANY 如 . 丁^七 s 〜 3 ⑽丨 

doll^tio^ avc a 吖祝吒 you ve s ⑽ so 七 ar. 
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Collection initializers arc similar to object initializers 

G# gives you a nice bit of shorthand to cut down on typing when you need to 
create a list and immediately add a bunch of items to it. When you create a 
new List object, you can use a collection initializer to give it a starting list 

of items. It’ll add them as soon as the list is created. . 

You saw this CoAt a -few 

pages ago—i-t a hCW 
^ L-is-t<Shoc> 3hd -pills it with 
Shoe ob\c^*ts. 

List<Shoe> shoeCloset = new List<Shoe>(); J 


shoeCloset.Add(new Shoe() { Style 
shoeCloset.Add(new Shoe() { Style 
shoeCloset.Add(new Shoe() { Style 
shoeCloset.Add(new Shoe() { Style 
shoeCloset.Add(new Shoe() { Style 
shoeCloset.Add(new Shoe() { Style 














Style.Sneakers r Color 
Style.Clogs, Color = 
Style.Wingtips r Color 
Style.Loafers r Color : 
Style.Loafers r Color : 
Style.Sneakers r Color 


="Black" }) 
Brown" }); 

="Black" }) 
: M White" }); 
: n Red M }); 

="Green" }) 


Ko*ti^c how cddK SKoc objedt is 
•mrtializ^d v/i*tK i*U o>wr> oojcd*t 
m'rtializ^v-? Y^ou CBy\ r>cs*t inside 'N 
3 dollcd*tio^ mrtializjCV, jus*t like *this. \ 



You CBy\ B 6 ollectio 灼 

by -taking i*tcm 
七 was bc'mj added us*mg ^ddO 
by\A adding it *to -the s*ta*tcrwc^*t 

list 


List<Shoe> shoeCloset = new List<Shoe>() { 



TV^c s*ta 七⑽⑼七 *to 
七 he lis*b is -folloy/cd by 
duvly bva^kets 七 V^a 七 ， 
tor\*ta'm sefavate \v*l } 
sta*tcr«c^*U, separated by 

£.ommdS. 

V^juVc r\o*b Incited 

. u » 

Xjo usm^ 灼 

s*ta 七 m 
mrbalizjCV" — you ^3^ 
•mdude variables，W 



new Shoe() 
new Shoe() 
new Shoe() 
new Shoe() 
new Shoe() 
new Shoe() 


{ Style = Style.Sneakers r Color = "Black" }, 
{ Style = Style.Clogs , Color = "Brown" }, 

{ Style = Style.Wingtips r Color = "Black" }, 
{ Style = Style.Loafers, Color = "White" }, 

{ Style = Style.Loafers , Color = n Red n }, 

{ Style = Style.Sneakers , Color = "Green" }, 


A collection initializer makes your code more 
compact hy letting you comtine creating a 
list witk actcting an initial set oi items. 
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Let's create a List of Pucks 


Here’s a Duck class that keeps track of your extensive 
duck collection. (You do collect ducks, don’t you?) Create 
a new Console Application and add a new Duck class 
and KindOf Duck enum. 


Eadh dudk has a s'izjc—- this 

OY\t is n mdhes 



enums and collections 


this! 4^ 



w 




Some the dudks 

a\rc mallards. 





You^vc ^o*t some 
Musdovy dudks. 







A^a youve a 
v/oodc^ dcto > y s * 




Here's the initializer for your List of Pucks 

We’ve got six ducks, so we’ll create a List<Duck> that has a 
collection initializer with six statements. Each statement in the 
initializer creates a new duck, using an object initializer to set 
each Duck object’s Size and Kind field. Add this code to 
your Main () method in Program.cs: 




class Duck { 

public int Size; 
public KindOfDuck Kind, 

The ddss has -two public 
-Piclds. I 七 s also 30 七 some 
methods, yj\)\cM ho*! 
showing hcvc. 


enum KindOfDuck 

Mallard, 
Muscovy, 
Decoy, 


List<Duck> ducks = new List<Duck>() 


Wic’ll use Br\ 
tailed ^mdO-PPudk *to 

keep what 

so\rt ok dudks ate m 
youv- 乙 olled*tiorv 


new 

Duck () 

{ Kind = 

KindOfDuck.Mallard 

new 

Duck () 

{ Kind = 

KindOfDuck.Muscovy 

new 

Duck () 

{ Kind = 

KindOfDuck.Decoy, 

new 

Duck () 

{ Kind = 

KindOfDuck.Muscovy 

new 

Duck () 

{ Kind = 

KindOfDuck.Mallard 

new 

Duck () 

{ Kind = 

KindOfDuck.Decoy, 

if 

// This 

keeps 

the output 

from disappearing 

Console 

•ReadKey(); 



Size 


=17 }, 
=18 }, 
14 }, 

=11 }, 
=14 



f[dd Pudk a^d 

^'mdO-PPudk *to 
youv f\rojcd*t- 


}, / ou II be adding todt h> youv- WmO 
method -to p\riht -to -the dohsolc. /Wake 
， y° u k «P this Imc at the so -the 
^ ~ pay 如 stays opch Uhtil you hit a key. 
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getting your ducks in a row 

% 

Lists arc easy, but SORTING can be tricky 

It’s not hard to think about ways to sort numbers or letters. But what do you 
sort two objects on, especially if they have multiple fields? In some cases you 
might want to order objects by the value in the name field, while in other 
cases it might make sense to order objects based on height or date of birth. 

There are lots of ways you can order things, and lists support any of them. 


You could sort a list of ducks by size... 


So ^ d tallest io bi M cst".. 





or by kind. 



Sovtcd by k'md of du 乙 k"" - - 




Lists know how to sort themselves 

Every list comes with a Sort () method that rearranges all of the items 
in the list to put them in order. Lists already know how to sort most 
built-in types and classes, and it’s easy to teach them how to sort your own 



Tc^h^i^ally, i-t^s ir>o-t -the Lisi<T> ihai 
knows how -to so 浐七 itscl-f. H defends oy\ 
如 ICom}[>3\re\r<T> objedi, you’ll 

dbou'b 3 mimic- 


classes. 
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SortO 


*tKc l*is*t o( dutks is 
sov-ted, its ^o*t Ac same 
\ y \ i*t 一 bu 七 \ y \ 

d order. 
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IComparabk<Puck> helps your list sort its ducks You can make 


The List. Sort () method knows how to sort any type or class that implements the 
IComparable<T> interface. That interface has just one member — a method called 
CompareTo () . Sort ( ) uses an object’s CompareTo ( ) method to compare it with 
other objects, and uses its return value (an int) to determine which comes first. 

But sometimes you need to sort a list of objects that don’t implement IComparable<T>, 
and .NET has another interface to help with that. You can pass Sort () an instance of a 
class that implements 工 Comparer<T>. That interface also has one method. The List 
object’s Sort ( ) method uses the comparer object’s Compare () method to compare pairs 
of objects, in order to figure out which one comes first in the sorted list. 


Am object's ComparetoO method compares it to another object 

One way to give our List object the ability to sort is to modify the Duck class to 
implement 工 Comparable<Duck>. To do that, we’d add a CompareTo () method 
that takes a Duck reference as a parameter. If the duck to compare should come after the 
current duck in the sorted list, CompareTo () returns a positive number. 

Update your project’s Duck class by implementing IComparable<Duck> so that it sorts 
itself based on duck size: 


any class 
work witk tke 
List’s tuilt-in 
SortO metkoct 
ty kavingf it 
implement 

IComparatle<T> 

and actcting a 

CompareToO 

metkoct. 


class Duck : 工 Comparable<Duck> 
public int Size; 
public KindOfDuck Kind; 


^ 1/VliCh you irwpIcrwCh-t |Conf»pa\rablc<T>, you 
specify ihc type bc'mj you 

七 he dlass 


Most Com\>avcTo() 州 etWs 
look a lot tw»s. TWs 

|jf smaller, •• 七代 - 1. 
M j 栋彳代从 c same 似 

vt 


public int CompareTo(Duck duckToCompare) { 

if (this.Size > duckToCompare.Size) 
return 1; 

else if (this.Size < duckToCompare.Size) 
return -1; 


else 


return 0; 


you wa 朽七 to so\rt youv list -Pv-om smallest 
•to bi^cs*t, have Compav-cloO \rctum a 
positive r^umbev- i-P i*t’s 七 © a 

smaller ar\A a negative ^umbev- i-P its 
dornfav-'m^ "to a bijJCV ov\C- 


Add this code to the end of your Main () method above the call to Console . ReadKey () to tell 
your list of ducks to sort itself. Use the debugger to see this at work by putting a breakpoint in the 
CompareTo () method. 

ducks.Sort (); 





sort it out amongst yourselves 






Use IComparcrto tell your List how to sort Your List will 

sort ctiHerentl 


Lists have a special interface built into the .NET Framework that lets 
you build a separate class to help the List<T> sort out its members. 

By implementing the IComparer<T> interface, you can tell 

your List exactly how you want it to sort your objects. You do that by 
implementing the Compare () method in the I Compare r<T> interface. 
It takes two object parameters, x and y, and returns an int. If x is less than 
y, it should return a negative value. If they’re equal, it should return zero. 
And if x is greater than y, it should return a positive value. 

Here’s an example of how you’d declare a comparer class to compare 
Duck objects by size. Add it to your project as a new class: 


ctepencting on kow 
you implement 

IComparer<T>t 


Th i s 心 ― Uchis /Compaq 
ahd — 七， j ^ 

dah So ^"t ： Duck objects. 

IComparer<Duck> 


class DuckComparerBySize 


public int Compare(Duck x. Duck y) 




These will always 
the same type ir> 




南 . 


if (x.Size < y.Size) 
return -1; 

if (x.Size > y.Size) 
return 1; 
return 0; 




It ， 

sort ^ 

r\umbc\r 

object % should jo bcW 

objet-b y- ^ W lcss tW’ y. 




ficv*c s d method -fco pvnvt "the 

dudks \y\ a Lisi<pu^k>. 


r 


Add 七 his Pvm*tPudks method *to 
youv Pvoyam tlass *m youv fvojcd*t 
so you Cdiy\ dudks m a list 


public static void PrintDucks(List<Duck> ducks) 

{ 

foreach (Duck duck in ducks) 

Console.WriteLine(duck.Size.ToString() + "-inch 
Console.WriteLine("End of ducks!"); 


If 


Upd3*tc youv /1/lamO mC*thod *to td\\ 
\i bc-Povc By\A adtr you soirt 七 he 
list so you tdiY\ see *thc v-csul*ts| 

+ duck.Kind.ToString()); 
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Create ah instance of your comparer object 

When you want to sort using 工 Comparer<T >， you need to create a new 
instance of the class that implements it. That object exists for one reason — 
to help List. Sort () figure out how to sort the array. But like any other 
(nonstatic) class, you need to instantiate it before you use it. 


enums and collections 



Wc Ic-ft out coAt you already 

saw a -few pays ay> 

i\\t list Make suve 

you\r list bcW you tv-y *to sorb 

i 七 f |<f you dor/t, you II yi a m\\ 

po'mtcv- 


DuckComparerBySize sizeComparer = new DuckComparerBySize(); 

ducks • Sort (SizeComparer) ; ?ass Sort0 a 代 Wwb 如 

PrintDucks (ducks) ; ^ pudkCompav-cvBySiz^ object as rb 

fav-aw>c*tcv-* 

dudks gc*t soirted. _ _ 一 """" 






Multiple IComparer implementations, multiple ways 
to sort your objects 

You can create multiple I Comparer<Duck> classes with different sorting This 扣作 . 

logic to sort the ducks in different ways. Then you can use the comparer type. i dudk 

you want when you need to sort in that particular way. Here’s another duck 

comparer implementation to add to your project: / 4-k - /ou ^ 

/ ” 叱 nr v3 / ucs 

class DuckComparerByKind : IComparer<Duck> { 

< y • Kind) ^ :一 

■ 1； / so -bv,c du.ks a,c y- 

tased ov\ *t^c mdc% value c 


public int Compare(Duck x. Duck y) { 
if (x.Kind 
return 

if (x.Kind > y.Kind) 



return 1 


cy\uw- 


else 


return 0 


^rnd a ^rndO^P^k 

.. \ S v^ovj s 

- V 也，“ a 〆 ^ e ：： J 二 

sWd •- L W S ， 

^ompairc Churh ihdex values, whi^iT m sor ^ 
lets us pu-t -the duks ih 0 咖， 


(I i. ,, y^ozt^r thclh 

I^sihah have a d\U^i 
； cahih 9 ^ used < a，d > -to 


DuckComparerByKind kindComparer = 
ducks.Sort(kindComparer); 

PrintDucks (ducks) ; - - Sorted by V.\v\d o( du 乙 k 


new DuckComparerByKind(); 




dak sov-tihg 
匕 ode -Pov- youv* 
/WaihO rnC"thod. 
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pick a card, any card 




IComparcr can do complex comparisons 

One advantage to creating a separate class for sorting your ducks is 
that you can build more complex logic into that class — and you can 
add members that help determine how the list gets sorted. 

enum SortCriteria { 

SizeThenKind, 

KindThenSize, This Chum tells the object whidh 

} /v^ 夕 wa y the du^ks. 


If you don’t provide Sort () with 
an IComparer<T> object, it uses 
a default one that can sort value 
types or compare references. Flip to 
Leftover #6 in the Appendix to learn a 
little more about comparing objects. 


jive’s a w'OV'C C-ldss *to 

tompavc du^ks. |*ts CompavcO method 

•bakes 七 s3mc p3v"amc*bcv"s, bu 七 

looks at fubk SortBy kid *to 
\\o>n *to sovb dufi-ks- 


class DuckComparer : 工 Comparer<Duck> { 

public SortCriteria SortBy = SortCriteria.SizeThenKind; 



public int Compare(Duck x. Duck y) { 

if (SortBy == SortCriteria.SizeThenKind) 

if (x.Size > y.Size) 
return 1; 

else if (x.Size < y.Size) 
return -1; 

else 

if (x.Kind > y.Kind) 
return 1; 

else if (x.Kind < y.Kind) 
return -1; 

else 

return 0; 


t This i-P dhcdb -the Sov-tBy 

-field- l-P its set "to 

thch ii -f iv-si soirb ihc dudks by si% 
witli'm eadh siz_c it’ll sov-t 
the dudks by ihciv- kmd. 




else 


if (x.Kind > y.Kind) 
return 1; 

else if (x.Kind < y.Kind) 


Instead o( just 0 i-f the two 

du^ks av-c *thc same s\z^, the ^ompav-cv- 
dhcdks theiv k’md, By\A only v-c*tuv-^s 0 
i-f *thc two du^ks a\rc both *thc same 

sizjc 3 灼 d -the sdme k'md- 


else 


return -1; 

if (x.Size > y.Size) 
return 1; 

else if (x.Size < y.Size) 
return -1; 

else 

return 0; 



|-f SovtBy sc*t *to 

tompavcv -fiv-st sov-ts by i\\t 
k'md o-f dutk. |*f *tKc *b/o dutks avc 
same kmd, 七 b i 七 Cowarts -tKciv s\z£. 




DuckComparer comparer = new DuckComparer(); 

comparer.SortBy = SortCriteria.KindThenSize 
ducks.Sort(comparer); 

PrintDucks(ducks); 

comparer.SortBy = SortCriteria.SizeThenKind 
ducks.Sort(comparer); 

PrintDucks(ducks); 



>vc dallm^ du 也 .s 饮七 ). ‘ 

o\>\tci Aaa twis todtb> cr,a ok 
“丄 MamO me 七 W. p rt 了长广 d 

>yr-b a Whol Ws. 


Y/C 63y\ 

kc*fovc 

63V\ 


youv 


VC—sov 
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Create five random cards and then sort them. 


❶ DEBATE TO MAKE A JUMBUBD SBT O? 6ARDS_ 

Create a new Console Application and add code to the Main () method that creates five random 
Card objects. After you create each object, use the built-in Console . WriteLine () method to 
write its name to the output. Use Console . ReadKey () at the end of the program to keep your 
window from disappearing when the program finishes. 

0 DEBATE A 6UASS THAT IMPUBMBNTS XCo^Pa^<Ca^t>> TO S^ET THE CAEDS. 

Here’s a good chance to use that IDE shortcut to implement an interface: 
class CardComparer_byValue : 工 Comparer<Card> 


Then click on 工 Comparer<Card> and hover over the I. You’ll see a box appear underneath it. 
When you click on the box, the IDE pops up its “Implement interface” window: 


Sometimes it's a Irbtle \\ard *to 
y 七 ih\s bo% *to fof up, so i\\t 
I PE has a usc-ful jus 七 

pvess C't'rl—pcv-iod- 


IComparer<Card> 

implement interface 'IComparer< Card>' 

Explicitly implement interface 'IComparer^ Card> 


Click on “Implement interface IComparer<Card>” in the box to tell the IDE to automatically fill 
in all of the methods and properties that you need to implement. In this case, it creates an empty 
Compare () method to compare two cards, x and y. Write the method so that it returns 1 if x is 
bigger than y, -1 if it’s smaller, and 0 if they’re the same card. In this case, make sure that any King 
comes after any Jack, which comes after any 4, which comes after any Ace. 

Q MAKE SUES THE OUTPUT UOOKS Eld&HT. 

Here’s what your output window should look like after you click the button. 


you use the built - ih 

CohSolclVv-itcLihcO 
method, it adds a lihe 
"to this output. Console- 
Rcad^cyO waits -fov- you 
■to press a key bcW the 
pv-ogvarw Chds. 




file : ///C:/U sers/Publi c/Docu... 


random cards : 
of Diamonds 
n of Spades 
n of Hearts 
of Hearts 
ueen of Diamonds 

e sane cards, sorted 
euen of Hearts 
of Diamonds 
of Hearts 
n of Spades 
n of Diamonds 


n 



a 



Vou\r |Corwpa\rcV- 
object needs "to sov-t 
the dav-ds by value, 

SO the dav-ds with 

the lowest values are 
-fiv-si \y\ 七 he list 
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look it up 


6^ 


Create five random cards and then sort them. 


内 jRciSe 






If x has a biagcv- value, 
irc-tuv-h /. /-f x ； s value 
IS s wlle\r, \rc*tuv-h 
Remember both vc-tu^h 
S-btcmChts Chd the 
method immediately. 


class CardComparer_byValue : 工 Comparer<Card> 
public int Compare(Card x. Card y) { 
if (x.Value < y.Value) { 
return -1; 


if (x.Value > y.Value) 
return 1; 


if (x.Suit < y.Suit) 
return -1; 

} 

if (x.Suit > y.Suit) 
return 1; 


續 


1 〜 sui-ts. 



TV^csc staWcyrb —f 一 

以 “7 hav 严 

same value — ba 七 mca 於七 
夂 yrs 七七 … 。代 W staWyrts 
Y/cv"cy> 七 c 乂 c 乙 w 七 cd. 


return 0 




T 之仏 

the same—so \rciu\rr) 2jcy 0 . 


static void Main(string[] args) 


Random random = new Random(); 

Console.WriteLine("Five random cards:") 

List<Card> cards = new List<Card>(); 
for (int i = 0; i < 5; i++) 

{ 

cards.Add(new Card((Suits)random.Next(4), 

(Values)random.Next (1 r 14))); 
Console.WriteLine(cards[i].Name); 


Hcvc^s a gcr>cvid Lis*t 
<Jc Cav-d objedis *to 
s*to\rc davds. 0r\Ct 
•thcyVc m -the list \{!s 
easy *to so\rt 七 hem 

usmg a 的 ICompavcv*- 


Console.WriteLine(); 

Console.WriteLine("Those same cards, sorted:"); 
cards.Sort(new CardComparer—byValue()); 
foreach (Card card in cards) 

{ 

Console.WriteLine(card.Name); 

} 

Console.ReadKey(); < 
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We’re using Console. ReadKey () to keep 
console applications from exiting after they finish. 
This is great for learning, but not so great if you 
want to write real command-line applications. If 
you use Ctrl-F5 to start your program, the IDE 
runs it without debugging. When it finishes, it 
prints “Press any key to continue...” and waits for 
a keypress. But it doesn’t debug your program 
(because it’s running without debugging), so your 
breakpoints and watches won’t work. 
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Overriding a ToStriwgO method lets m object describe itself 

Every .NET object has a method called ToString () that converts it to a string. By default, it just returns the name 
of your class (MyPro j ect. Duck). The method is inherited from Ob j ect (remember, that’s the base class for every object) 
This is a really useful method, and it’s used a lot. For example, the + operator to concatenate strings automatically calls 
an object’s ToString () method. And Console . WriteLine () or String. Format () will automatically call it 
when you pass objects to them, which can really come in handy when you want to turn an object into a string. 


Go back to your duck sorting program. Put a breakpoint in the Main () method anywhere after the list is initialized and 
debug your program. Then hover over any ducks variable so it shows the value in a window. Any time you look at 
a variable in the debugger that’s got a reference to a List, you can explore the contents of it by clicking the + button: 


0'*^ ducks {MyProject.Duck[6]} 


Thc |PE dal Is the ToS*tv"m^O method v/h ⑶ i*t displays 
objedt m i*U window. But ToS*tv"'m^O 

method pudk mhev-ited -Pv-om Objcdt jus-t 
its dlass 的 ame. I 七 would be v-cally useful i-P wc dould 
mdke ToS*tv"m^O m-fo\rma*tivc. 

Hmm, that’s not as useful as we’d hoped. You can see that there are six Duck objects in the list 
(“MyProject” is the namespace we used). If you click the + button next to a duck, you can see 
its Kind and Size values. But wouldn’t it be easier if you could see all of them at once? 


分 cluck: {MyProject.Duck[6]} 

□ 0 [0] 

{MyProject.Duck} 


□ • [1] 

{MyProject.Duck} 


E# [2] 

{MyProject.Duck} 


E# [ I] 

{MyProject.Duck} 


□ • [4] 

{MyProject.Duck} 


□ [ 5] 

{MyProject.Duck} 




So 'mstcad o-f 

a value -to 

Co^solclV\ri*tcL'mcO, 

ctd., you cav\ pass 
By\ objedt—its 
ToS*t\rm^O method is 
called au-toma-ti^ally. 

That also y/o\rks y/i*th 
value types like mts 
c^ums, ioof 


Luckily, ToString () is a virtual method on Ob j ect, the base class of every object. So all you need to do is 
override the ToString () method — and when you do, you’ll see the results immediately in the IDE’s Watch 
window! Open up your Duck class and start adding a new method by typing override. As soon as you press space, 
the IDE will show you the methods you can override: 

override 


V Equals[object obj] 
GetHashCodeQ 


^jToStringO 

string object.ToStringO 

Returns a System .String that represents the current System. Object. 



Click on ToString () to tell the IDE to add a new ToString () method. Replace the contents so it looks like this: 
public override string ToString() 


return "A 


Size 


inch 


Kind.ToString(); 


Run your program and look at the list again. Now the IDE shows you the contents of your Duck objects! 

"the shows 

you Sr) object, ii 匕 alls 七 he 
objed's ToSVmgO r^eihod 

shows you i-ts 匕 。灼七 e 灼 ts. 


□ 

0 cluck: 

{MyProject.Duck[6]} 


田 _ [0] {A 17 inch Mallard} 

! - 


mm [1] 

{A IS inch Muscovy} 



田 • [2] {A 14 inch Decoy} 



□ • [3] 

{All inch Muscovy} 



□ _ [4] 

{A 14 inch Mallard} 



[5] {A 13 inch Decoy} 



you are here 
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foreach loopy 


Update your foreach loops to let your 
Pucks and Cards print themselves 

You’ve seen two different examples of programs looping through a list of objects and calling Console . 
WriteLine () to print a line to the console for each object — like this foreach loop that prints every card 
in a List<Card>: 


foreach (Card card in cards) 

{ 

Console.WriteLine(card.Name); 

} 

The PrintDucks () method did something similar for Duck objects in a List: 

foreach (Duck duck in ducks) 

{ 

Console.WriteLine(duck.Size.ToString() + "-inch 


Y^>u also love off U .7oS"t\rih^0 w 
ahd "the + opc\rol-tov* will ca\\ it 
au-fcorwol-ti^lly. 



+ duck.Kind.ToString()); 


This is a pretty common thing to do with objects. But now that your Duck has a ToString () method, 
your PrintDucks () method should take advantage of it: 


public static void PrintDucks(List<Duck> ducks) { 

foreach (Duck duck in ducks) { 

Console .WriteLine (duck) ; l-r you pass Co^solcl/V\ri-tcL*mcO 


Console.WriteLine("End of ducks!") 

} 


a io objedt, i-t will 

匕』七 ha 七 object’s ToSiv-m^O 
mcihod au-tomaiidally. 


Add this to your Ducks program and run it again. It prints the same output. And now if you want to add, say, 
a Gender property to your Duck object, you just have to update the ToString () method, and everything 
that uses it (including the PrintDucks () method) will reflect that change. 


Add a ToString!) method to your Card object too 

Your Card object already has a Name property that returns the name of the card: 


public string Name 

{ 

get { return Value.ToString() 


YouVc s*till allowed *to dall 
loS*tv-*m^O like 七 his, bu 七 ⑽ >w 
you k 灼 o>w its y \ o {, ^edessav-y m 

this tast, \)tta\Ast + tails i*t 
au*toma*t*idally. 


of " + Suit•ToString(); 



That’s exactly what its ToString () method should do. So add a ToString () method to the Card class: 


public override string ToString () 

{ 

return Name; 

} 

Now your programs that use Card objects will be easier to debug. 
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ToStv'm^O is usc-ful -fov d lot move 
making youv objects easier *to idc^y m IPt- 
youv eyes opcr\ ovcv -Pew 

a”d you II V^oy/ useful it is U cvev-y 
have a way 乙。灼败七 *to a s*brm} T^ats 

y/W/ cvcvy object V^as a ToSVm^O method. 
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preach 

Up CjaSe 




Whew you write a forcach loop, 
you're using IEwumerable<T> 

CoWcchov\ ihitializicv-s wovk 

Go to the IDE, find a List<Duck> variable, and use IntelliSense to take a look at its AHY IBy\un\c\rMc<T> 

GetEnumerator () method. Start typing “.GetEnumerator” and see what comes up: 3s lohg as i -(： also has a 

method ^lled AddO. 

ducks,GetEnumerator 

[List< Duck> .Enumerator List<Duck> .GetEnumeratorO 

Returns an enumerator that iterates through the System .Col lections. G en eri c. List< T >. 




GetEnumerator 


Add a line to create a new array of Duck objects: 

Duck[] duckArray = new Duck[6]; 

Then type duckArray. GetEnumerator — the array also has a GetEnumerator () method. 
That’s because all Lists, and arrays implement an interface called IEnumerable<T>, which 
contains one method. That method, GetEnumerator (), returns an Enumerator object. 

It’s the Enumerator object that provides the machinery that lets you loop through a list in order. 
Here’s a for each loop that loops through a List<Duck> with a variable called duck: 


foreach (Duck duck in ducks) { 

Console.WriteLine (duck) ; 

} 

And here’s what that loop is actually doing behind the scenes: 

工 Enumerator<Duck> enumerator = ducks.GetEnumerator() 
while (enumerator.MoveNext()) { 

Duck duck = enumerator.Current; 

Console.WriteLine (duck) ; 

} 

工 Disposable disposable = enumerator as 工 Disposable/ 
if (disposable != null) disposable.Dispose(); 


Wlten a collection 
implements 

IEnumeratle<T>, 

it’s giving you a way 
to write a loop tkat 
goes tkrougli its 
contents in order. 


(Don’t worry about the last two lines for now. You’ll learn about I Disposable in Chapter 9.) 

Those two loops print out the same ducks. You can see this for yourself by running both of them; 
they’ll both have the same output. 


little 

Wt Y ou Y 七七 k idea *•• 


Here’s what’s going on. When you’re looping through a list or array (or any other collection), 
the MoveNext () method returns true if there’s another element in the list, or false if the 
enumerator has reached the end of the list. The Current property always returns a reference to 
the current element. Add it all together, and you get a foreach loop! 

Tvy wi*th this by youv puck's ToSVmjO -to mdrem ⑶七 the SiiC f\rofC\rty. pebuj youv f\roya» 

and hovcv ow a Pudk. Th ⑶ do rt Rcw'CmbcV", CBCM time you do i*t, IPE dalls To£"tv"mjO method. 




What do you think would happen during a foreach loop if your ToStringO 
method changes one of the object’s fields? 


you are here ► 
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nobody here but us ducks 


You caw upcast an entire list using (Enumerable 

Remember how you can upcast any object to its superclass? Well, when you’ve got a 
List of objects, you can upcast the entire list at once. It’s called covariance, and all 
you need for it is an 工 Enumerable<T> interface reference. 

Create a Console Application and add a base class, Bird (for Duck to extend), and a 
Penguin class. Well use the ToString () method to make it easy to see which class is which. 



class Bird { 

public string Name { get; set; } 

public virtual void Fly() { 

Console.WriteLine("Flap, flap"); 

} 

public override string ToString() { 

return "A bird named " + Name; 



Duck 


Penguin 

Size 

Kind 




Wtrts a Biv-d dlass, aY\d a dlass that 


class Penguin : Bird 

{ 

public override void Fly() { 

Console.WriteLine("Penguins can't fly!") 

} 

public override string ToString() { 

return "A penguin named " + base.Name; 


-Pvom i*t- Add "them *to a W/ Console 
fv-ojed-t, dofy youv- Pudk 

tlass m*to it Jusi i*b Att\arahoY\ so 七 ha 七 

•rt Biv-d- 

class Duck : Bird, 工 Comparable<Duck> { 

// The rest of the class is the same 


Here are the first few lines of your Main () method to initialize your list and then upcast it 

List<Duck> ducks = new List<Duck>() { /* initialize your list as usual * 

工 Enumerable<Bird> upcastDucks = ducks; 



Copy the same dollc^tioh 
youVc 

usiK>j -fco youv* 

List o( du^ks. 


Take a close look at that last line of code. You’re taking a reference to your List<Duck> and assigning it to an 
工 Enumerable<Bird> interface variable. Debug through it, and you’ll see it’s pointing to the same object. 

Combine your birds into a single list 

Covariance is really useful when you want to take a collection of objects and add them to a more general list. Here’s an 
example: if you have a list of Bird obects, you can add your Duck list to it in one easy step. Here’s an example that 
uses the List. AddRange () method, which you can use to add the contents of one list into another. 
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You caw build your own overloaded methods 

You’ve been using overloaded methods and even an overloaded constructor 
that were part of the built-in .NET Framework classes and objects, so you can 
already see how useful they are. Wouldn’t it be cool if you could build overloaded 
methods into your own classes? Well, you can — and it’s easy! All you need to do is 
write two or more methods that have the same name but take different parameters. 




thi 


o 


❿ 


r Uo tl 

♦ 


is ， 


/ - 


Create a new Console Application project and add the Card class to it. 

You can do this easily by right-clicking on the project in the Solution Explorer and selecting Existing 
Item from the Add menu. The IDE will make a copy of the class and add it to the project. The file 

will still have the namespace from the old project, so go to the top of the Card.cs file and 

change the namespace line to match the name of the new project you created. Then do the same 

^ - ± - - 

for the Values and Suits enums. 


(|\kc oldMmcspatc.Od 人 


-bo atdcss 

Add some new overloaded methods to the Card class. 

Create two static DoesCardMatch () methods. The first one should check a card’s suit. The 
second should check its value. Both return true only if the card matches. 


public static bool DoesCardMatch(Card 
if (cardToCheck.Suit == suit) { 
return true; 

} else { 

return false; 


cardToCheck, Suits suit) { 

■to be siaii^ bu-t i-t s good 
■to get a little rwo\rC 

s-ta-tid methods. 


public static bool DoesCardMatch(Card cardToCheck, Values value) { 
if (cardToCheck.Value == value) { 
return true; 

} else { 

return false; 



Add code to Main () to use the new methods. 

Add this code to the Main () method in Program.es: 


Card cardToCheck = new Card(Suits•Clubs, Values.Three); 

bool doesItMatch = Card.DoesCardMatch(cardToCheck, Suits.Hearts); 

Console.WriteLine(doesItMatch); 


As soon as you type DoesCardMatch ( the IDE will show you that you really did build an 
overloaded method: Card. Dee star dMat ch( 

* 1 of2 T bool C a r d« Do es C a r dWa tch( C □ rd cardFoClieckj Suits suit) 

Take a minute and play around with the two methods so you can get used to overloading. 

you are here ► 
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all hands on deck 



«ciSe 


Get some practice using Lists by building a class to store a deck of cards, 
along with a form that uses it. 


Q BUIUD A POEM THAT U 5 TS Y^U M^>V 5 CARDS B 5 TW 55 N 丁 WO DECKS. 

You’ve built a Card class already. Now it’s time to build a class to hold any number of cards, which we’ll call 
Deck. A real-life deck has 52 cards, but the Deck class can hold any number of cards — or no cards at all. 

Then you’ll build a form that shows you the contents of two Deck objects. When you first start the program, 
deck #1 has up to 10 random cards, and deck #2 is a complete deck of 52 cards, both sorted by suit and 
then value — and you can reset either deck to its initial state using two Reset buttons. The form also has 
buttons (labeled ” and “>>”) to move cards between the decks. 

These bu*t*fco^s avc movcToPcd-kZ (*fcop) a 灼 d movcToPcdkl 

(bottom). They move dav-ds -fv-om oy\c AttV b> the other: 

Q Vwo Decks 


Remember, you can use a 
control’s Name property to 
give it a name to make your 
code easier to read. Then 
when you double-click on 
the button, its event handler 
is given a matching name. 


丁 he \reseil av\d rcsciZ 
but-tohs dal I the 
ResciVcM method ahd tkh 
七 he RcdmawDcdkO method. 


Deck #1 (9 cards) 


Bght of Spades 
King of Spades 
Bght of Clubs 
: Nine of Clubs 
Two of Diamonds 
Six of Diamonds 
Four of Hearts 
Ten of Hearts 
Jack of Hearts 




Deck #2 (52 cards) 

Ace of Spades 
Two of Spades 
Three of Spades 
Four of Spades 
jHve of Spades 
jm of Spades 
r Seven of Spades 
Eight of Spades 
Nine of Spades 
Ten of Spades 
Jack of Spades 
Queen of Spades 
King of Spades 
Ace of Clubs 
Two of Clubs 
Three of Clubs 



Use "two L-istBox 6oh"t\roU "to 
show the two de^ks. iVhch the 
^oveToVeM bu-t-toh is 

it rwoves the selected 
A*orw dttV #Z -to dedk 养 1 , 

These ku*tW are 
yvd^ed sKuWlcI 
sKuWlci. T\>cy tall 

affv-ofv-'ia-tc Pctk. 
SVmWlcO ^cb)od, ayvd 
仏⑼ v-cdv-a>w detk. 


— Heset Deck #1 

Reset Deck #2 


Shuffle Deck #1 

ihuttle Deck #2 



In addition to the event handlers for the six buttons, you’ll need to add two methods for the form. First add a 
Re set Deck () method, which resets a deck to its initial state. It takes an int as a parameter: if it’s passed 1， it 
resets the first Deck object by reinitializing it to an empty deck and a random number of up to 10 random cards; 
if it’s passed 2, it resets the second Deck object so that it contains a full 52-card deck. Then add this method: 


private void RedrawDeck(int DeckNumber) 
if (DeckNumber == 1) { 

listBoxl • 工 terns•Clear(); 

lake a look at 

」 foreach (string cardName in deckl.GetCardNames()) 

nov; v/c used *thc y — 一" * 

p . I I listBoxl • 工 terns .Add (cardName); 

add eadh°5 the labell - Text 
dav~ds m *thc else { 

listBox2. 工 terns•Clear(); 



Deck #1 (" + deckl.Count + " cards) 


^dvawD^kO me-thod 
shu-Pflcs -the dtek, dv-dws 
Whdom lairds -Pvom \i, ahd 
upda-tes the -two listbox 
^ohtvols with whatever 
j^ppchs -to be ih the two 
De 匕 k obje 匕 ts. 


lis*tbo>c. 


foreach (string cardName in deck2.GetCardNames()) 
listBox2 . 工 terns . Add (cardName); 
label2.Text = "Deck #2 (" + deck2.Count + " cards) 
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❻ 


BUIUD TH5 1>BCK 6UASS. 


厂 W\\tY\ you have -the dcdlava*tior>s <Pov a dlass 

( wrthou 七七 he irwplci^C^*t3*tio^ i*ts ddllcd S skeleton. 


TV\c 

|^umcvaWc<Cavd>, 

M lc*ts 70 U ?ass 
叫 tollc^om mto 

to 的 stv'ut'tov, } 

,ot>staUst<T> 

ov av> avva^. 


Here’s the skeleton for the Deck class. We’ve filled in several of the methods for you. You’ll need to finish it 
by writing the Shuffle () and GetCardNames () methods, and you’ll have to get the Sort () method 
to work. We also added two useful overloaded constructors: one that creates a complete deck of 52 
cards, and another that takes an array of Card objects and loads them into the deck. 

广 The Dcdk s-fcoves i-ts ^dv~dls m a Lis*t—bu*t i*t keeps 
class Deck { X i*t pv-iva*tc *to make suv~c rt’s well 

private List<Card> cards; 

private Random random = new Random () ; l*f yo\A doY\ "t p3ss pavamctcv-s 

乙 o 灼 s^bruttov*, i*t Creates 

a Complete deck o( davds. 

I 

for (int suit = 0; suit <= 3; suit++) 

for (int value = 1; value <= 13; value++) 

cards.Add(new Card((Suits)suit, (Values)value)); 



public Deck ( 工 Enumerable<Card> initialCards) 
cards = new List<Card>(initialCards); 



public int Count { get { return cards.Count; 


public void Add (Card cardToAdd) 
cards.Add(cardToAdd); 


cvc^ -though 
6ieiCsrdHsn\csO 
\rc*tu\r^s 


The Deal method deals o^e c^d 
} 〆 ~■ out of tk dak — it v-emoves -the 

/K Cavd object -P\rom the dtdc av\d 

public Card Deal (int index) { v-ctuv*hs a io ii /ou 

Card CardToDeal = cards [index] ; ^ the iof the 

▽ f A by passing it O, ov- deal 

Wow\ the middle by pass'rn^ i-t 
ik ihdex -the uyA -to deal. 


cards.RemoveAt(index); 
return CardToDeal; 


"This ovcv*loadcd do^s-tv*ud*to\r -(^kes oy\C 
pa\ramete\r—a 灼 av-\ray o( cards, whidh 
it loads ds -the m'rbidl dtcM. 

七 : 七 he L'»s*tBo% 
Co^broU ScIcttcdUdc% 
pVO^CV**tY *tV)C 

same as i\\t mdc^ 

*tV\c tavd m *t^c l»s*t- 
You cav\ pass »*t 
•to i\\t PcalO mc*tKod. 

card sclented, 
^11 be less *tKa^ 
h tasc, *t^c 
movcToPctk Wtbm 
should do 


public void Shuffle() { 

// this method shuffles the cards by rearranging them in a random order 


avv-ay, wc expose } 
|E^umc\rablc<stv-m5^*- 


- 

public IEnumerable<strinq> GetCardNames() { 

// this method returns a string array that contains each card's name 


public void Sort() { 

cards.Sort(new CardComparer bySuit()) 




,jull r\ttA *bo v/v-i*tc Shu-f-flcO 

method a 灼 d the ^ctCav-dNa^csO 

rwc*thodi, a^d add a dlass 
implcmCi^*ts |Compa\rC\r *to make *thc 
So\rtO method y/ovk- you’ll 
Y\tcd *to add Cav-d dlass you 

alv-cady v/v-o-tc- l-f you use Add 
|*tcm *to add it do^*t 
-fov-yt *bo i*ts ^a^cspadc- 


you are here ► 
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exercise solution 



Build a class to store a deck of cards, along with a form that uses it. 


内 jRciSe 


class Deck { 

private List<Card> cards; 

private Random random = new Random(); 

public Deck() { 



WtYts, the ^o^s-t\rud-tov that dv-catcs a 
deck o( c^ds. H uses a hesied 4v- loop. The 
ou-fcsidc ov\t loops "thvough the -fouv sui-fcs- That 
mca^s -the inside loop lha-t goes thv-ough -the \l 
values \TUhS -fou\r scpa^lc times, oUt fev- suit 


cards = new List<Card>(); 
for (int suit = 0; suit <= 3; suit++) 

for (int value = 1; value <= 13; value++) 

cards.Add(new Card((Suits)suit, (Values)value)); 


public Deck ( 工 Enumerable<Card> initialCards) 
cards = new List<Card>(initialCards); 

} 

public int Count { get { return cards.Count; 

public void Add(Card cardToAdd) { 
cards.Add(cardToAdd); 


public Card Deal(int index) { 

Card CardToDeal = cards[index] 
cards.RemoveAt(index); 
return CardToDeal; 




s o 七 ^ tlass 

V,as W overloaded each 

Y /狀 d.1 以⑽七 favamc-bc'rs. 



The Add a-d methods a, c ㈣ y 

：r ihc The Del method 

T d J^ ihc lisi ^ 

^od adds a card h> the list. 




public void Shuffle() { 

List<Card> newCards = new List<Card>() 
while (cards.Count > 0) { 

int CardToMove = random.Next(cards.Count) 
newCards.Add(cards[CardToMove]); 
cards.RemoveAt(CardToMove); 

} 

cards = newCards; 

} 

public 工 Enumerable<string> GetCardNames() { 

string[] CardNames = new string[cards.Count]; 
(int i = 0; i < cards. Count; i++) 


、丁 he Shu-PflcO method dv-catcs a 

hCW L\si<Card> called 

hcwCamds. Thch it pulls Mhdom dav-ds 
out o+ -the da\rds -field ahd sticks 
them \ hcv/Ca\rds Uh-til ^ds is empty. 

it’s dohe, it v-cscts the wds 
士 ield "to poiht -to the hew ihstahdc. 
old \v\sia^t woh'-t have mov»c 
poihtmg h> \i, so itll get 
toWttitd by the gav-bage toWttW 


CardNames[i] 
return CardNames 


cards[i].Name; 


public void Sort() { 

cards.Sort(new CardComparer_bySuit()) 

} 


n/ouv 七七 CaU) —w 巧 d 广 

V,oid all 6avd TV,.s o^t 

U loo ? , but \i to^\d also use UtacW 
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class CardComparer_bySuit : 工 Comparer<Card> 

{ 一 

public int Compare(Card x. Card y) 

{ 

if (x.Suit > y.Suit) 
return 1; 

if (x.Suit < y.Suit) 
return -1; 

if (x.Value > y.Value) 
return 1; 

if (x.Value < y.Value) 
return -1; 

return 0; 



by suit is d \oi like 

sortmj by value- or\) 

\s 七七 m 七 Wis 

cast su'i-ts arc Compared 
-f'ivst 3r\d i^tY\ values 

avc tomfaved o\r\ly i-f 七 he 
surts 


Deck deckl ; 
Deck deck2; 
Random random 


new Random() 


Instead us'mj \ (/ else 
i-f, Y/c used d senes Jc i-f 
S*ba 七⑽ rrb. This Y/ovks 
bedduse tacM i-f sta 七⑽灼七 
only c^cCuies tiic previous 
oy\c d»d^*b 一 o*t^cv"y/isC) *b^c 
^v*cvious ok\c would V>avc 
yc*buvir\cd- 


public Forml() { 

工 nitializeComponent(); 
ResetDeck(1); 

ResetDeck(2); 
RedrawDeck(1); 
RedrawDeck(2); 



丁 k £.OhS"tv*ut*toV* 

y\ccds *to Preset 〜 0 

de 乙 ks, 扣 d rt d^rav/s 

*b^cw\. 


private void ResetDeck(int deckNumber) { 

if (deckNumber == 1) { 

int numberOfCards = random•Next(1, 11); 

deckl = new Deck(new Card[] { }); 

for (int i = 0; i < numberOfCards; i++) 

deckl.Add(new Card((Suits)random.Next(4), 

(Values)random.Next(l f 14))); 


deckl.Sort(); 

} else 

deck2 = new Deck(); 


You^vc already jo*t 七 he 

Rcdv-awDcdkO method 



^ p $: 口’上 i:{ h ; d i !^ rd e ^ 

St a : e T pty dedk . L ‘ C 

如 k. R e 7 e ii^ 5 2cktz !hty heS U 呤。如 3 忪 

o-p VcMX y ~J ust ⑽七… 〜 


七 he ms-t\rudtio^s. 


► We ? re not done yet-flip the pa^e! 
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you can look it up 



内 jRciSe 
©PLlitlOH 

(cpHtlHv^P) 


Karn'm^ youv dov>*tvols makes *rt a \oi casicv *to v-cad 
youv dodc- l*f *tKcsc >wcvc tailed bu*t*tor>l — Clidk, 
buttor>2 • 一 CU, t\l- t you 職 1 ‘七 ky>ov/ v/iVidh 
bu-tWs dodc you y/eve lookm^ ail 



private void resetl_Click(object sender, EventArgs e) 
ResetDeck(1); 

RedrawDeck(1); 


private void reset2_Click(object sender, EventArgs e) 
ResetDeck(2); 

RedrawDeck(2); 


private void shufflei—Click(object sender ( 
deckl.Shuffle(); 

RedrawDeck(1); 


EventArgs e) 


private void shuffle2_Click(object sender ( 
deck2.Shuffle(); 

RedrawDeck(2); 


EventArgs e 


忏？ W J the 
^odt \oy -the 4 


These but-fcohs ^>rt 

Pretty simple 一(•的七 
代 set oir shu-P-flc the 
dak' "thch v*cdv*c>w i*t ， 


private void moveToDeckl_Click(obj ect sender, EventArgs e) { 
if (listBox2•Selectedlndex >= 0) 
if (deck2.Count > 0) { 

deckl.Add(deck2.Deal(listBox2.Selectedlndex)); 

} 

RedrawDeck(1); 

RedrawDeck(2); 


private void moveToDeck2_Click(obj ect sender, EventArgs e) 
if (listBoxl•Selectedlndex >= 0) 


if (deckl.Count > 0) 

deck2.Add(deckl.Deal(listBoxl.Selectedlndex)); 
RedrawDeck(1); 

RedrawDeck(2); 



t^y\ use the ListBox 

乙 oht\ro”s Sclc^tcdlhdoc j>v-opcv-ty 

"to -Pigu\rc out whidh C^yA ihc 
use\r seeded av\d -thch •^ovc i-t 
-P\rom ot\t AttV -to the other. (|*f 
its less tholh 'zjcyo, y\o Uvd WolS 
selected, so the but-fcoh does 

ho-thihj.) Out the card's moved, 

both dc^ks Y\ttd {jo be \rcdv-awh. 
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Use a dictionary to store keys and values 

A list is like a big long page full of names. But what if you also want, for each name, an 
address? Or for every car in the garage list, you want details about that car? You need a 
dictionary. A dictionary lets you take a special value — the key — and associate that key 
with a bunch of data — the value. And one more thing: a specific key can only appear 
once in any dictionary. 


This is key. li 

how You look up 

3 j h a 


s 


(dic.tion.ar.y 


di^ii 


•Ohdlry. 


A book that lists the words of a language in 
alphabetical order and gives their meaning. 


Here’s how you declare a Dictionary in G#: 


TVis is 七 he value. Its i\\t data 



Dictionary <Tkey, TValue> kv = new Dictionary <TKey, TValue>() 


- 、 ^ -- 

TV^csc arc like Ust<T>. The <T> means 
d -type ^ocs m *biicv"c. So you C9v\ dc£.l3v~c 
type for *bi^c key, ar\o*t^cv* 
for value- 


Tkse \rcpvcsch-t types. The -fivs-fc 
type ih "the dhglc b^keis is always 
the key, 3hd the sc^ohd is dlwdys 
the dais. 


And here’s a Dictionary in action: 

private void buttonl 一 Click (object sender, EventArcps e) 

Dictionary<string^ P string> wordDefinition = keys, Sr\d s-tvi^vls v ^^ ucs ^o\r 

new Dictionary'string, string 〉（）； \rcsl ^ a 

^ 5hd dc^\i\ OY ,, 

^ - ^ ~ 

TV^ ^ddiO wordDefinitiotfTAdd ^"Dictionary" , "A book that lists the words of a " 

ctV'od > s ^ -+ "language in alphabetical order and gives their meaning"); 

add wordDefinition.Add ("Key", "A thing that provides a means of gaining access to M 

7 OVA . { + "our understanding something•’▼) ; AdM) 4 - I 

\ ! a ㈣ s 5 wordDefinition. Add ("Value", "A quantity, number, string, or reference .”）； . , cs ^ 

仏 “ 、出。叫 . ^ y y key, ahd 

the value. 
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keys and values 


The dictionary fuwctiowality rundown 


Dictionaries are a lot like lists. Both types are flexible in letting you work with lots of data types, 
and also come with lots of built-in functionality. Here are the basic Dictionary methods: 

冷 Add an item. 

You can add an item to a dictionary by passing a key and a value to its Add () method. 

Dictionary<string, string 〉 myDictionary = new Dictionary<string, string 〉（）； 
myDictionary.Add("some key", "some value"); 

冷 Look up a value using its key. 

The most important thing you’ll do with a dictionary is look up values — which makes 
sense, because you stored those values in a dictionary so you could look them up using 
their unique keys. For this Dictionary<string, string〉, you’ll look up values using a 
string key, and it’ll return a string. 


string lookupValue = myDictionary["some key"]; 

冷 Remove an item. 


Just like a List, you can remove an item from a dictionary using the Remove () method. 
All you need to pass to the Remove method is the Key value to have both the key and the 


value removed. 

myDictionary.Remove("some key"); 


冷 Get a list of keys. 



Ays = uhi^uc ih a key appeav-s exactly 

oUc w appear a^y d t.r ， cs-two keys 

have the sar^c value. Thai way, you look up o^ 
^cr,ovc a key, the Di^io^v-y khows what remove. 


You can get a list of all of the keys in a dictionary using its Keys property and loop 
through it using a foreach loop. Here’s what that would look like: 


foreach (string key in myDictionary.Keys) { ... }; 

.. # is a pvopcvty you\r di^io^vy object TKis pav-t^ular 

冷 Count the pairs in the dictionary. ai^o^ayy v^as sVmj keys, so ^ is a o\ stvmy. 

The Count property returns the number of key-value pairs that are in the dictionary: 

int howMany = myDictionary.Count; 


Your key and value can be different types 


Dictionaries are really versatile and can hold just about anything, from strings to numbers and even objects. 
Here’s an example of a dictionary that’s storing an integer as a key and a Duck object reference as a value. 


|*t’s *bo sec 3 

did*bior>av"Y maps 
'mtc^cv-s *to objct*U 
VouVc 3 IP 
r\u^bcvs *to objects. 


Dictionary<int, Duck> duckDictionary = new Dictionary<int, Duck>(); 

duckDictionary.Add(376, new Duck() 

{ Kind = KindOfDuck.Mallard, Size =15 }); 


388 Chapter 8 


enums and collections 


Puild a program that uses a dictionary 

Here’s a quick program that any New York baseball fan will like. When an 
important player retires, the team retires the player’s jersey number. Let’s 
build a program that looks up who wore famous numbers and when those 
numbers were retired. Here’s a class to keep track of a jersey number: 

class JerseyNumber { 

public string Player { get; private set; } 
public int YearRetired { get; private set; } 



public JerseyNumber(string player, int numberRetired) { 
Player = player; 

YearRetired = numberRetired; 


Here’s the form: 


And here’s all of the code for the form: 


Yogi Berra was #8 for one team and Cal Ripken, Jr” 
was #8 for another. Butin a dictionary only one 
key can map to a single value, so we’ll only include 
numbers from one team here. Can you think of a 
way to store retired numbers for multiple teams? 


Retired Jersey Numbers 



Number 


23 


was worn by Don Mattingly 


and retired in 


1997 


public partial class Forml : Form { 

Dictionary<int, JerseyNumber〉retiredNumbers = new Dictionary<int, JerseyNumber 〉（） 


{3, new JerseyNumber("Babe Ruth", 1948)}, 

{4 r new JerseyNumber("Lou Gehrig " f 1939)}, 

{5 , new JerseyNumber("Joe DiMaggio ", 1952)}, 

{7 r new JerseyNumber("Mickey Mantle ", 1969)}, 
{8, new JerseyNumber("Yogi Berra", 1972)}, 

{10, new JerseyNumber("Phil Rizzuto ", 1985)}, 
{23, new JerseyNumber("Don Mattingly", 1997)}, 
{42, new JerseyNumber("Jackie Robinson ", 1993) } 
{44, new JerseyNumber("Reggie Jackson ", 1993)}, 


Use 3 ^ollcdtio^ 
'mi-tialiicv- *bo populate 
you\r Di^tio^av-y v/i 七 h 
JcvscyNunrvbcv- objects. 


public Forml() { 

InitializeComponent(); 

foreach (int key in retiredNumbers.Keys) 
number. 工 tems•Add(key); 

} 

} 


/ - -Md key 

did*tior>avy *to 
{ ComboBoVs Items 


private void number_SelectedIndexChanged(object sender, EventArgs e) { 

JerseyNumber jerseyNumber = retiredNumbers[(int)number.Selectedltem]; 


nameLabel.Text = j erseyNumber.Player; 
yearLabel.Text = j erseyNumber.YearRetired.ToString() 


Wsc the ComboBoxs ScIc^cdlhdcxC^hgcd cvcht 

V. 吁 dwo labels oh -fov-m with the 

p alucs ^ vJc\rscy/Vur«bcv- objc^ rcbr\^d 
*hrorn "the Didtiohavy. 


-The CorwboBo^S Sclcdicdltcrw 
piropcirty is at\ Object S'mdc ihc 
Didtiohairy key is art y/C Y\ccd 
"to 匕岛七 i 七 *to 扣 nrt value bc-Po\rc 
doir^j the lookup \y\ the Didtiohav-y. 
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go fish! 


晨 




Build a game of Go Fish! that you can play against the computer. 


This exercise is a little different.... 

There’s a good chance that you’re learning G# because you want a job as a professional developer. That’s 
why we modeled this exercise after a professional assignment. When you’re working as a programmer on a 
team, you don’t usually build a complete program from start to finish. Instead, you’ll build a piece of a bigger 
program. So we’re going to give you a puzzle that’s got some of the pieces already filled in. The code for the 
form is given to you in step #3. You just have to type it in — which may seem like a great head start, but it 
means that your classes have to work with that code. And that can be a challenge! 


O START UJITH TH5 Spec- 

Many professional software projects start with a specification, and this one is no 
exception. You’ll be building a game of the classic card game Go Fish! Different people 
play the game by slightly different rules, so here’s a recap of the rules you’ll be using: 

* The game starts with a deck of 52 cards. Five cards are dealt to each player. 
The pile of cards that’s left after everyone’s dealt a hand is called the stock. 
Each player takes turns asking for a value (“Do you have any sevens?’’). Any 
other player holding cards with that value must hand them over. If nobody has 
a card with that value, then the player must “go fish” by taking a card from the 
stock. 

* The goal of the game is to make books, where a book is the complete set of all 
four cards that have the same value. The player with the most books at the end 
of the game is the winner. As soon as a player collects a book, he places it face¬ 
up on the table so all the other players can see what books everyone else has. 

* When placing a book on the table causes a player to run out of cards, then he 
has to draw five more cards from the stock. If there are fewer than five cards 
left in the stock, he takes all of them. The game is over as soon as the stock is 
out of cards. The winner is then chosen based on whoever has the most books. 


H you 
cton’t know 
wkat you’re 
Indicting 
before you 
start, tken 
kow woulct 
you know 
wken you’re 
ctone? 

Tkat’s 

wky many 

professional 

software 


* For this computer version of Go Fish, there are two computer players and one 
human player. Every round starts with the human player selecting one of the 
cards in his hand, which is displayed at all times. He does this by choosing one 
of the cards and indicating that he will ask for a card. Then the two computer 
players will ask for their cards. The results of each round will be displayed. 

This will repeat until there’s a winner. 

* The game will take care of all of the trading of cards and pulling out of books 
automatically. Once there’s a winner, the game is over. The game displays 

the name of the winner (or winners, in case of a tie). No other action can be 
taken — the player will have to restart the program in order to start a new game. 


projects 
start witk 
specificatio 


a 

n 


tkat tells 
you wkat 


you’re going 
to Indict. 
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O euiut> THB 

Build the form for the Go Fish! game. It should have a ListBox control for the player’s 
hand, two Text Box controls for the progress of the game, and a button to let the 
player ask for a card. To play the game, the user will select one of the cards from the 
hand and click the button to ask the computer players if they have that card. 


TK'is cov\bro\ should V>avc 

Kdme set b> 

sd,saWcd, Wt \is^\A be 
enabled ▲ 如 哼批 sia 士 . 


B g 


Your name 

|H " 

Game progress 



disab,ed - ^ 


Go Fish! 


Your hand 


Start the game! 



TKcsc av-c 

Te% 七 Bo% 

£.or\*tv"ols 
七 wtPvoyess 
av\A -bc^tBooks. 



Ed asks f anyone has a Ten 

Joe has {] Tens 

Bob has 0 Tens 

!Bd must draw from the stock. 

Joe asks if anyone has a Kjng 

Ed has {} Kings 

Bob has Q Kings 

Joe must draw from the stock. 

Bob asks if anyone has a Four 

Ed has D Foure 

Joe has § Foure 

Bob musft draw fnam the stock. 

Ed has 9 cards. 

Joe has 7 cards. 

Bob has 9 cards. 

The stock has 7 cards left. 


Two of Spades 
Two of Diamonds 
Two of Hearts 


Seven of Spades 


Seven of Diamonds 
Seven of Hearts 
Ten of Spades 
Ten of Dubs 
Ten of Diamonds 



Books 




Bob ihas a book of Aces 
Ed lhas a book of Sixes 
Ed has a book of Nines 
Bob has a book of Eights 
Joe has a book of Queens 


.Askfora card 


s 


The f la〆 ： 

hand is 
displayed m a 

Lis*bBo>c doivbrol 
called lis-ttta^d. 
V^OU CBy\ set its 

Name f\rofCV-*ty. 


Set the RcadOhly pv-opev-ty 
ihc two TcxtBox ^ohtvol 
to W-that will make them 
iread-ohly -text b< 

^lultilihc X»roVe)r\ 



3hd set "the 
,hC P^opcirty -to tvuc. 


Set 七 his bu*bbcm’s Msme p\ropcv-*ty -fco butto 灼 3r\d srt its Enabled 
pv-opc\rty *bo -false- That will disable 'rt ； >n\\\C\\ mca^s i*t be 
pv-csscd- The -Povm will enable 'rt ds sooy\ ds -the game s-tav-ts. 

- ► Wre not done yet-flip the pa^e! 


you are here ► 
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here’s the form code 


m 


O THB COt>B FOJ2, THB 


Enter it exactly like you see here. The rest of the code that you write will have to work with it. 



TViis is i\\t or^ly tlass tVic SoY 州 

■tcvat-b y/itiv It vurts i\\t ^olc ^amc. 


丁 “aWed 

ov a 

C.oy\tvol or\ 
fovw. 


public partial class Forml : Form 
public Forml() { 

InitializeComponent(); 

} 


private Game game; 


private void buttonStart_Click (object sender, EventArgs e) { 
if (String • 工 sNullOrEmpty(textName•Text)){ 

MessageBox.Show("Please enter your name ", "Can't start the game yet"); 
return; 


game = new Game(textName.Text 
)uttonStart.Enabled = false; 
textName.Enabled = false; 
buttonAsk.Enabled = true; 
UpdateForm(); 


new List<string> 


Joe' 


'Bob" }, textProgress); 


you stavt a mew game, it tyeaies a 


hCW 




'^siauc o-P the dass, cables the Ask 
fuWoh, disables the bu 七 

thch \rcd\raws the (OV^. 


This rhethod 
^lcav-s a^d 
\rCpopulatcs 
the i-is^Box 

"that holds 
the flayev-s 
hhd, dhd thch 
updates tKc } 
text boxes. 


private void UpdateForm() { 

listHand • 工 tems•Clear(); 

foreach (String cardName in game.GetPlayerCardNames()) 
listHand • 工 tems.Add(cardName); 
textBooks.Text = game.DescribeBooks(); 
textProgress.Text += game.DescribePlayerHands(); 
textProgress.SelectionStart = textProgress.Text.Length; 
textProgress.ScrollToCaret(); 


private void buttonAsk 一 Click (object sender, EventArgs e) 
textProgress.Text =""; 
if (listHand•Selectedlndex < 0) { 

MessageBox.Show("Please select a card"); 
return; 


^ s,h 9 ScIc^-tiohS-tav-t av\d 

S^\roll7oCa\rc-tO like this 
spoils the text box -to -the 
Chd, so i-f thcv-c s -too mu 匕 h 
-to display ov\tc it 
s ^ olls dowh io the bottom. 

.T 

^Ic^-tiohStairt lihC moves 
七 k flashihg ie%i box ^soy 
"to "the tv\d) 3hd otiCt 

^oy/cd, the S 仆 ollToCa^tO 

•method Stolls -the -tex-t box 
dowh -to the 匕 uvsov. 


if (game•PlayOneRound(listHand•Selectedlndex)) 
textProgress.Text + 二 "The winner is... " + 
textBooks.Text = game.DescribeBooks(); 

buttonAsk.Enabled = false; The playcv sclcd*ts 


game.GetWinnerName() 


else 

UpdateForm() 


Pl^ou,dO method 5 3 ^ ^ 


、3 "the 
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o 


you f uu Neet> this cor>e, too. 

You’ll need the code you wrote before for the Card class, the Suits and Values enums, the Deck 
class, and the CardComparer_byValue class. But you’ll need to add a few more methods to the 
Deck class.. .and you’ll need to understand them in order to use them. 

^ ' 丁 k P«kO method lets you take ^ 

public Card Peek (int cardNumber) { feck at ohC o( the ^avds iy> the AttV 


return cards[cardNumber] 


without ii. 


public card Deaio { 

return Deal(O); 咖 d A L W ohk dktk. 


a 


public bool ContainsValue (Values value) 
foreach (Card card in cards) 
if (card.Value == value) 
return true; 
return false; 



The Corrtams\/alucO method scathes -thv-oujh 
the cir\*ti\rc AtcY -fo\r dav-ds y/i*th a value, 

\rrtums *tv"uc i-f i*t -fmds a^y. you 
^uess how you’ll use 七 his ’m *thc 6jo Fish jamc? 


public Deck PullOutValues (Values value) { 

Deck deckToReturn = new Deck(new Card[] { }); 

for (int i = cards.Count - 1; i >= 0; i- 
if (cards[i].Value == value) 

deckToReturn.Add(Deal(i)); 
return deckToReturn; 



V^u II use the PullOutl/alucsO 
i^rthod whch you build ihe CoAt io 
yt a book da\rds -Pv-orw -the dct\c. 
1 七 looks -Po\r a^y da\rds i^ai 
a value, pulls therw out o-p the dttV } 

\rclu\fhs a hew dc^k wi-th those 
^d\rds ih i-fc. 


public bool HasBook (Values value) 
int NumberOfCards = 0; 
foreach (Card card in cards) 
if (card.Value == value) 
NumberOfCards++; 
if (NumberOfCards == 4) 
return true; 

else 

return false; 



public void SortByValue() { 

cards.Sort(new CardComparer byValue()) 


HasBook0 mc*t^od diicdks a 
dedk *to see i-f *i*t dorrta’ms a book 
0-(* *PouV £.3V"ds o-f v/ii3'tcvcv" value 
\nBs passed as fav-amc*tcv-. |*t 
v-ctuv-r>s br\At d book m 

-tiic dedk, -false o*tV>cvv/isc. 


^ g r iB y VM -e-thod 


^ -- Luyvdl 

；il So ^ deck 


usihg a 

C^dCor,pa^^byl/alue objc^. 

Still not done-flip the pa^e! 


► 


you are here ► 
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go get } em tiger! 


晨 


ton% Ex^RCtS^ (cpHtlHv6p) 


O N^)W CO/^BS TH5 WAED PAET ： BUIUD TH5 Puaybis 6UASS. 

There’s an instance of the Player class for each of the three players in the game. They 
get created by the buttonStart button’s event handler. 


class Player 


get { return name 


private string name; 
public string Name { 
private Random random; 
private Deck cards; 
private TextBox textBoxOnForm; 


job ,s io f,|| i h ihe methods. 


r ouv- 


public Player (String name. Random random, TextBox textBoxOnForm) 


// 

// 

// 

// 


The constructor for the Player class initializes four private fields, and then 
adds a line to the TextBox control on the form that says, "Joe has just 
joined the game"—but use the name in the private field, and don't forget 
add a line break at the end of every line you add to the TextBox. 


// see the facing page for the code 


public 工 Enumerable<Values> PullOutBooks() { 

public Values GetRandomValue() { 

// This method gets a random value—but it has to be a value that's in the deck! 



public Deck DoYouHaveAny (Values value) { 

// This is where an opponent asks if 工 have any cards of a certain value 
// Use Deck.PullOutValues() to pull out the values. Add a line to the TextBox 
// that says , "Joe has 3 sixes"—use the new Card.Plural() static method 


public void AskForACard (List<Player> players, int mylndex. Deck stock) { 

// Here's an overloaded version of AskForACard()—choose a random value 
// from the deck using GetRandomValue() and ask for it using AskForACard() 

} ^ Thc\rc ; s a rare dase v/hcr\ av\ las-t cavd was -takers by ahothev playev, so he has ⑽ 

v/h ⑶ /\skf"o\r/\C3V"dO is ddllcd- you ou*t ， hov/ "to dcdl 七 his £ ， 3sc? 

public void AskForACard (List<Player> players, int mylndex. Deck stock. Values value) { 

// Ask the other players for a value. First add a line to the TextBox : "Joe asks 
// if anyone has a Queen". Then go through the list of players that was passed in 
// as a parameter and ask each player if he has any of the value (using his 
// DoYouHaveAny() method). He'll pass you a deck of cards—add them to my deck. 

// Keep track of how many cards were added. If there weren't any, you'll need 
// to deal yourself a card from the stock (which was also passed as a parameter ), 
// and you'll have to add a line to the TextBox : "Joe had to draw from the stock" 

} 

// Here's a property and a few short methods that were already written for you 
public int CardCount { get { return cards.Count; } } 

public void TakeCard (Card card) { cards.Add(card); } 

public 工 Enumerable<string> GetCardNames () { return cards.GetCardNames(); } 

public Card Peek (int cardNumber) { return cards.Peek(cardNumber); } 

public void SortHand () { cards.SortByValue(); } 
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A Couple mov-c 

O YOU^U N55D lO ADD THIS METHOD JO TH5 Puaybis CLASS.-to 

Here’s the PullOutBooks () method for the Player class. It loops through each "thmk about 
of the 13 card values. For each of the values, it counts all of the cards in the player’s 
cards field that match the value. If the player has all four cards with that value, 
that’s a complete book — it adds the value to the books variable to be returned, and it 



o 


removes the book from the player’s cards. 

public 工 Enumerable<Values> PullOutBooks() { 

List<Values> books = new List<Values>(); 
for (int i = 1; i <= 13; i++) { 

Values value = (Values)i; 
int howMany = 0; 

for (int card = 0; card < cards.Count; card++) 
if (cards.Peek(card).Value == value) 
howMany++; 
if (howMany == 4) { 

books.Add(value); 
cards.PullOutValues(value); 


Tha*t PcckO method >wc added 

-to -the Pctk dlass Will dome 
•m I*t lc*b fvoyam 

look d 七 oy>c o-P 七 he d3v*ds m 
i\\t AttV by i-b mdex. 
r^umbev-, bu*t unlike PcalO i*t 
docsh ； *t v-emove tav-d- 


return books; 


youll have -to build TWO overloaded vevsio^s 
of IhcAskFov-AC^v-dO method. The (Wsi ohc 

is used the whch they ask -Pov- 

^avds—itll look through thci\r \\av\ds av\d -fihd 
a da\rd *to ask -fov-. The stCot\A o^c is used 
the plavc\r asks -fo\r the G\rd. Both o( them 


playc\r dsks 

； °thc\r playev- (both domputev- aK>d 

humah) -fo\r any tavds lha-t ma-Uh -the value. 

YOU^U N55D TO ADD THIS METHOD TO TH5 C^t> 6UASS. 

It’s a static method to take a value and return its plural — that way a 10 will return 
‘Tens’’ but a 6 will return “Sixes” (with “es” on the end). Since it’s static, you call it with 
the class name — Card. Plural () — and not from an instance. 


public partial class Card { 

public static string Plural(Values value) { 
if (value == Values.Six) 
return "Sixes"; 

else 

return value.ToString() + "s"; 


0t\tt you build 七 he 
w ^sk -Pov* s dav*d” 
buttov/s CVCir>*t 
handler, you dan also 
hook -the Lis 七 Box’s 
PoublcClitk ewt 
uf *to rt so you t3r\ 
also double — didk oy\ 
a dav-d *fco ask (or *rt- 


roperties 


liistHand System .Wind ows.Fo rms.Li stElox 


v 早 X 


1/Vc used a fav 七 ial dlass -to add 七 his 
s*t3tid mc*thod *to Cavd *to make i*t 
easy (or you *to see >wKa*t ； s ^o*m^ 
orv Bu 七 you do^*t *to use a 
partial dlass—i-P you wa 此 you 
ddr> jus 七 add \i mio 七 he 

Cbv'A dlass. 


□== 


❹ Y] f 





DoubleGick 


buttonAsk Click 


M ouseCa ptu reC hanged 

MouseClick 

MouseDoubleClick 


button Start Click 


buttonAsk Click 


▲ 




Nearly Aere-^keep flipping! 


you are here ► 
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book r em danno 



tpr^S E 站 iu 部 6 (cpHtiH^P) - 

O TH5 126ST O? TH5 BUILD TH5 加 Me CLASS. 

The form keeps one instance of Game. It manages the game play. Look 
\ p r closely at how it 5 s used in the form. p |a 扣 d d | asses both use a bo 

private List<Player> players; ^ mul 七 ilme the {o 你 essays 

private Dictionary<Values, Player 〉 books; *fov* "tW usev* "to vead. /l/Iskc su\rc you ddd usip 

private Deck stock/ Sys*tcw'-lA/"n^dioy/s-l^ov*w\S^ "to "tKc or "tKciv* t.iIcs. 

private TextBox textBoxOnForm; 

public Game (string playerName, 工 Enumerable<string> opponentNames, TextBox textBoxOnForm) 
Random random = new Random(); 
this.textBoxOnForm = textBoxOnForm; 
players = new List<Player>(); 

players.Add(new Player(playerName, random, textBoxOnForm)); 
foreach (string player in opponentNames) 

players.Add(new Player(player, random, textBoxOnForm)); 
books = new Dictionary<Values, Player 〉（）； 


stock = new Deck(); 
Deal (); 

players[0].SortHand() 


Its ycat (oy c^dapsulatio^, -too. I-P 77 
you expose By\ |E^umc\rablc<T> mstcad ^ 
say ； a List<T>, you da^*t 
addide^ially write todc that modif ies it. 


Using IEnumerable<T> 
in public class members is 
a great way to make your 
classes more flexible, and 
that’s something you need 
to think about when your 
code needs to be reused. 
Now someone else can use a 
string[], List<string>, 
or something else entirely to 
instantiate the Game class. 


private void Deal() { 

// This is where the game starts—this method 1 s only called at the beginning 
// of the game. Shuffle the stock, deal five cards to each player, then use a 
// foreach loop to call each player's PullOutBooks() method. 


public bool PlayOneRound (int selectedPlayerCard) { 

// Play one round of the game. The parameter is the card the player selected 
// from his hand—get its value. Then go through all of the players and call 
// each one's AskForACard() methods, starting with the human player (who's 
// at index zero in the Players list—make sure he asks for the selected 
// card's value). Then call PullOutBooks()—if it returns true, then the 
// player ran out of cards and needs to draw a new hand. After all the players 
// have gone, sort the human player's hand (so it looks nice in the form). 

// Then check the stock to see if it * s out of cards. If it is, reset the 
// TextBox on the form to say, "The stock is out of cards. Game over !’， and return 
// true. Otherwise, the game isn't over yet, so return false. 


public bool PullOutBooks (Player player) { 

// Pull out a player * s books. Return true if the player ran out of cards, otherwise 
// return false. Each book is added to the Books dictionary. A player runs out of 
// cards when he r 's used all of his cards to make books—and he wins the game. 

} 

public string DescribeBooks() { 

// Return a long string that describes everyone's books by looking at the Books 
// dictionary : "Joe has a book of sixes. (line break) Ed has a book of Aces." 


396 Chapter 8 







enums and collections 


Wcrcs a (or ih c ^iW\^^0 mc^od ： youII ^cd -to 加 ah a _ Did^avyc+i 唧 m*t> called 

wmhcv-s at the -top o\ the method. The wih^ers didiio^avy will let you use cadh player’s rta^e -to look uf ihe number 
^ , bo f s hc 7 adc d 价 … 3 七 ^ 3 a < ^ you’ll u 试 a Wadh loop to 30 books 七 ha 七 ^ flay 的 made a^d 

7 ，ld ^ 丁一 you II use a^Y Wadh loop to frnd the W^i d books assodialcd y/ilh a^y 

『 13 巧个卞七一 r^hUe a 七卜⑽代七 ‘ cme flaycv have the most books/ So youll ^cd Wadh 

loop to look \oY all the playevs m wmws ihai have _bev d books i\^ai you (o^d m iht seto^d Ioop build 
st\r'ma savs v/Ko v/o^. 


a 


public string GetWinnerName () { 

// This method is called at the end of the game. It uses its own dictionary 

// (Dictionary<string, int> winners) to keep track of how many books each player 

// ended up with in the books dictionary. First it uses a foreach loop 

// on books•Keys— foreach (Values value in books.Keys )—to populate 

// its winners dictionary with the number of books each player ended up with. 

// Then it loops through that dictionary to find the largest number of books 
// any winner has. And finally it makes one last pass through winners to come 
// up with a list of winners in a string ("Joe and Ed"). If there's one winner, 

// it returns a string like this : "Ed with 3 books". Otherwise, it returns a 
// string like this : M A tie between Joe and Bob with 2 books." 


// Here are a couple of short methods that were already written for you : 


public 工 Enumerable<string> GetPlayerCardNames() 
return players[0].GetCardNames(); 


public string DescribePlayerHands() { 

string description =，"，； 

for (int i = 0; i < players.Count; i++) { 

description += players[i].Name + " has " - 
if (players[i].CardCount == 1) 

description += " card." + Environment.NewLine; 

else 

description += " cards." + Environment.NewLine; 


players[i].CardCount 


description += "The stock has 
return description; 


stock.Count 


cards left. 


-to the IVatdh 
wihdow and type 

-to cast -the 
^ha\ra^-tc\r \v -to a 
^urnbc\r. li -tuv-hs ih-to 
\h tuv-hs ih*to lO. 
Ev^y ^ tuv-hS ih-to 
its ovm uhi^uc humbev- 

called its Unicode 
value. \4u’ll leav-h 
^o\re about that 
hext dhaptev-. 


Usc 铋 add Irnc bv-caks 

/ou ; vc bcch usm 9 \ h throughout ihe book h> add li^e bv-eaks h> ^ssaac box« WET . , 

17 r ub " b: 心心 - 省 71 
anally look at the 乙 ― 七 hH” W^s^aiicd W ^,| c +u a J ： Y °\ 

s ” : 。 卿二 (like t d ^ 

: ad : he /WessageBox-ShowO ^ihod is sn，M enough b a^ahcally to ^i 'V cha^dte« l> I' 

^ ^ 岬 — d ⑽ —I 岫 ‘ y ou use C ㈣ I ■ 紅岫 0 . 
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exercise solution 



tog ExjRdSe 
SPLvtiPH 


OY 

a 


A-Ptcv the play 饮 

oppohCht asks (o\r 
^d, the game pulls 
out books -that he 

'ade. m playev-'s out 
。士 ^3v-ds, he dv~dws 3i 
hCW ‘d by dcalihg up 

^ 匕扣 ds +vom the 

sUk. 


Here are the filled-in methods in the Game class. 

The DcalO method jets dal led y/lich the 

private void Deal () { 5^^^ S'tdvts — it shu-Pflcs "the AttV 3hd 

stock. Shuffle () ; ~ ⑶ deals -rive ddvds -to playev". Thch 

for (int i = 0; i < 5; i++) i*t pulls out a^y books that "the playevs 

foreach (Player player in players) happened to have beCh dealt 
player.TakeCard(stock.Deal()); 
foreach (Player player in players) 

PullOutBooks(player); 


public bool PlayOneRound (int selectedPlayerCard) { 

Values cardToAskFor = players[0].Peek(selectedPlayerCard).Value; 
for (int i = 0; i < players.Count; i++) { 

if (i — — 0) 

players[0].AskForACard(players, 0, stock, cardToAskFor); 

else 

players[i].AskForACard(players f i, stock); 

(PullOutBooks(players[i])) { 

textBoxOnForm.Text += players[i].Name 

+ " drew a new hand" + Environment.NewLine; 

int card = 1; 


if 


while (card <= 5 && stock.Count > 0) 
players[i].TakeCard(stock.Deal()) 
card++; 

} 


players[0].SortHand(); 
if (stock.Count == 0) 
textBoxOnForm.Text 

"The stock is out of cards. Game over 


As SOOY\ as -the flayev- dl'itks -the w Ask 
-Pov- a dav-d w bui*tor>, 七 he tails 

AskFovACav-dO wrth 七 V>a 七 dav-d- TV>cr> 
*rt tails AskFovACavdO (or cadh 


Environment.NewLine 


return true 


return false; 


A 付一 is played, -the game sov-ts the 

S T akc Su，rc '^ s dis P^y^ ov-dev- oh 

I 士 1 七 is, PlayOhcRouhdO \rctuv-hs tv-uc. 


OVCV-. 


public bool PullOutBooks (Player player) 


IEnumerable<Values> booksPulled = player.PullOutBooks(); 
foreach (Values value in booksPulled) 
books.Add(value A player); 
if (player.CardCount == 0) 

itg tu.]rn tiruG * — f % _ - 墨，， 

return false; docs, i\\q added *to Wis books A\thoY\a^ 


j, pullOutBoobO looks a flay^s ^ds 

•，- f s -four cards W\i\\ tV^c same value. 1^ ^ 

dots, tV^cv (\ti added *to Wis books » 

以 5 3 oUo cards \t^i aA 饮 • 山••七 true. 
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The -Po\rrh heeds {o display a lis-t o( books, 
so 1 七 uses Dcs^v-ibcBooksO -to tuwthc 
players books d^tiohav-y ih-to wov-ds. 

public string DescribeBooks() { 

string whoHasWhichBooks =""; 
foreach (Values value in books.Keys) 

whoHasWhichBooks += books[value].Name + " has a book of " 

+ Card.Plural(value) + Environment.NewLine; 
return whoHasWhichBooks; 



public string GetWinnerName() { 

Dictionary<string, int> winners = new Dictionary<string, int> () 
foreach (Values value in books . Keys) { 

string name = books[value].Name; ) 

if (winners.ContainsKey(name)) 
winners[name]++; 

else 

winners.Add(name, 1); 


Out last card's be ⑼ p'idked up, ^ 

needs -to out y/o”. Ti^aVs 

〜 tlVnrmevNa 你 e() docs. f[v\d 

iVII use a dittio^avy tailed y/'m^evs -to 
do it- i-acM flayev’s Y\an\t is a key m 
dit*t'ior>avy ； i*b value is i\\t ^u^bev o-f books 
flaycv ^o*t duv'm^ 


\ 


int mostBooks = 0; 

foreach (string name in winners.Keys) 
if (winners[name] > mostBooks) 
mostBooks = winners[name]; 
bool tie = false; 
string winnerList =""; 

foreach (string name in winners.Keys) . , 

if (winners [name] == mostBooks) py/ith -blic most books \)Bs. H puts 七 

{ value \v\ B vdiridble ddlled ^os-tBooks. 

if (!String. 工 sNullOrEmpty(winnerList)) 


blt%i -the looks -thv-oujh -the didlio^avy 
■to -f igure ihc r>urwbc\r o-P books ihai 七 he 


winnerList += 
tie = true; 

} 

winnerList += name 


and 


winnerList 
if (tie) 

return 

else 

return 


with 


mostBooks 


books 


Now tha-t wc khoy/ y/hidh player 

has the 眯 os 七 books, the rwc-thod 
Gh ton\t up y/ith a s-tv-'mj -that 
ilists 七 he wihhcv- (o\r y/'mir>cvs). 


'A tie between 


winnerList 


winnerList; 


► We ? re not done yet-flip the pa^e! 
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tpHg ExjRClSe - 

§PL|itIpH CcpHtlHv^P) 


Here are the filled-in methods in the Player class. 


public Player(String name , Random random, 
this.name 二 name; 
this.random = random; 
this.textBoxOnForm = textBoxOnForm; 
this.cards = new Deck( new Card[] {} 

textBoxOnForm.Text += name + 


TextBox textBoxOnForm) { 

lie\re s 七 he dor>s-tvud-to\r -Pov- the Playcv- dlass. 
|七 sets its p\rivaic -fields a^d adds a I'me b> 
； 七 k p\rog\rcss ic^i box say'mg who jomed- 


has just joined the game" + Environment.NewLine; 


public Values GetRandomValue() { 

Card randomCard = cards.Peek(random.Next(cards.Count)); 




return randomCard.Value; 


The ^c*tRa^dom\/alucO method uses PcckO *to 
look at a random card *m ihe flayers Kav>d- 


public Deck DoYouHaveAny(Values value) { 

Deck cardsIHave = cards.PullOutValues(value); 
textBoxOnForm.Text += Name + " has " + cardsIHave•Count 
+ Card.Plural(value) + Environment.NewLine; 
return cardsIHave; 


DoYouHavcA^yO uses 
n " the PullOu*t\/alucsO 

rweihod -to full oui 3r\d 

’ - ^ v-ctu\rr> all da\rds 七 ha 七 

rwatdh 七 he pav-arwetev-. 


public void AskForACard(List<Player> players , int mylndex. Deck stock) { 

if (stock.Count > 0) { 〆 K 如 oPPo _Uaw up his las 七 dard, 心 ifUdUA/alueO 

"(=S : 二 :: ; ^" V,ll ,all LlO o, f e, P i Y nese ^ 

Values randomValue = GetRandomValue () ; fv*cvcn*t -rv-orw 


AskForACard(players, mylndex, stock, randomValue); 


public void AskForACard(List<Player> players , int mylndex. 

Deck stock. Values value) { 
textBoxOnForm.Text += Name + " asks if anyone has a " 

+ value + Environment.NewLine 

int totalCardsGiven = 0; 

for (int i = 0; i < players.Count; i++) { 

if (i != mylndex) { 

Player player = players[i]; 

Deck CardsGiven = player.DoYouHaveAny(value) 
totalCardsGiven += CardsGiven.Count; 
while (CardsGiven.Count > 0) 

cards.Add(CardsGiven.Deal()); 


TV^cvc av-c *bwo overloaded 
^skFov-ACav-dO mc*t^ods. 
TV^c -f iv-s-t ov\t is used by 
•(Jie oppoy\cir\*ts 一 i*t y*bs a 
da\rd -fv*ow> 

V^a^di a^d ^alls i\\t o*tV^c\r 

/\skFov-ACavdO. 




if 


(totalCardsGiven == 0 && stock.Count > 0) { 

textBoxOnForm.Text += Name + 

"must draw from the stock. n + Environment.NewLine; 
cards.Add(stock.Deal()); 


This AskFo\rACav-dO method 
looks -thv-oujh cvcvy playcv- 
(exdep 七 -Pov- the oy\c askm ^)； 
tails its DoYouttavcA^yO 
method, a^dl adds a^y dav*ds 
handed ovcir -to -the hdhdl- 


y\o ddv-ds v/eve Kar>dcd ovcv ； 
{\\t flaycv dv-av/s -fvom {\\t 
s*fcotk usm^ i*ts PcdlO method 
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Bonus mini-exercise: Can you figure out a way to improve encapsulation and design 
in your Player class by replacing List<Player> with IEnumerable<Player> 
in the two AskForACard () methods without changing the way the software 
works? Flip to Leftover #8 in the Appendix fora useful tool to help with that. 









enums and collections 


Awd yet MORE collection types... 


List and Dictionary objects are two of the built-in generic collections that are 
part of the .NET Framework. Lists and dictionaries are very flexible — you can access any 
of the data in them in any order. But sometimes you need to restrict how your program 






works with the data because the thing that youVe representing inside your program works ^^ . i .m 

like that in the real world. For situations like this, you’ll use a Queue or a Stack. Those ： , 

are generic collections like List<T>, but they’re especially good at making sure that your 6© 妁切 ’ 
data is processed in a certain order. 


Use a Queue when the first 
object you store will be the first 
one you’ll use, like: 

★ Gars moving down a one-way street 

★ People standing in line 

★ Customers on hold for a customer 
service support line 

★ Anything else that’s handled on a 
^ first-come, first-served basis 

LA is -fiv-s-t—ih -fivst—out, whidh 

你 ㈡ hS "that the -f irst obve^t that 

• - . 

you put ihto the queue is the -fiv-st 
erne you pull out o4 - it "to use. 


Use a Stack when you always want 
to use the object you stored most 
recently, like: 

★ Furniture loaded into the back of a 
moving truck 

* A stack of books where you want to 
read the most recently added one first 


People boarding or leaving a plane 

A pyramid of cheerleaders, where the 
ones on top have to dismount first … 
imagine the mess if the one on the 
bottom walked away first! 



TVic sta^k »s last-m, - ou 七:如 o\>\td 

从 at yes ••山如 staUk last w ba 七 

C.on\CS ou*t o-f it 


Generic collections are an important part of 
the .NET Framework 

They’re really useful — so much that the IDE automatically adds 
this statement to the top of every class you add to your project: 

using System.Collections.Generic; 

Almost every large project that you’ll work on will include some 
sort of generic collection, because your programs need to store 
data. And when you’re dealing with groups of similar things in 
the real world, they almost always naturally fall into a category 
that corresponds pretty well to one of these kinds of collections. 

\/ou can, hov/cy/cr, use ^cortacM *to 〆 ^ 

a s-tad-k or 


A queue is like a list 
tkat lets you put 
objects on tke end ol 
tke list anct use tke 
ones in tke front. A 
stack only lets you 
access tke last otject 
you put into it. 


you are here ► 
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don’t you hate waiting in line? 


A queue is FIFO—First Iw, First Out 

A queue is a lot like a list, except that you can’t just add or remove items at any 
index. To add an object to a queue, you enqueue it. That adds the object to the 
end of the queue. You can dequeue the first object from the front of the queue. 
When you do that, the object is removed from the queue, and the rest of the objects 
in the queue move up a position. 


C^rcaie « 
o-P s-tHhjs. 


Queue<string> myQueue = new Queue<string>(); 

add 


PcckO lets 

you take 
a w look w at 
•the -Piv-s 
•rtem m the 
queue wi*thou 七 
i*t- 



myQueue.Enqueue( 
myQueue.Enqueue( 
myQueue.Enqueue( 
myQueue.Enqueue( 
string takeALook 
string getFirst = 
string getNext = 


1 first in line n ); 
▼second in line TI ) 

1 third in line"); 
’last in line"); 

=myQueue.Peek() 

: myQueue.Dequeue() 
myQueue. Dequeue () ，•⑧ 




Hcvcs >WC add ^ouv 

Vtwto ^ ^ ^ 

Dull OU*b 

七 dome ou*t 'V' sawe 

ovdev- 





㈡ 


TV^c ClcavO 

method 

objects 

i\\t 


int howMany = myQueue. Count ，•④ 
myQueue.Clear(); 

MessageBox.Show( n Peek() returned: n + takeALook + n \n n 
+ "The first Dequeue() returned: n + getFirst + n \n 
+ "The second Dequeue () returned: ▼’ + getNext + n \n 
+ ’’Count before Clear () was n + howMany + n \n n 
+ "Count after Clear () is now n + myQueue. ^unt) 

queues Couht p\ropc\rty v4tuv-h 
xk hurwbc\r o( itcr^s ih the c^ueue. 




Objcd-ts ih a 
<\ucuc heed -to 
wait thci\r tuv-h. 
The -Piv-s-t Ohe ih 
the is -the 

OhC -fco Covv\t 
out o-p it 



PeekQ returned: first in line ① 

The first DequeueQ returned: first in line ® 

The second DequeueQ returned: second in line @ 
Count before ClearQ was Z ® 

Count after ClearQ is nowO ④ 


OK 


402 Chapter 8 


















enums and collections 


A stack is UFO — Last Iw, First Out 


A stack is really similar to a queue — with one big difference. You push each item 
onto a stack, and when you want to take an item from the stack, you pop one off 
of it. When you pop an item off of a stack, you end up with the most recent item 
that you pushed onto it. It’s just like a stack of plates, magazines, or anything else- 


you can drop something onto the top of the stack, but you need to take it off before 

you can get to whatever^ underneath it. ^ 』 

7 6 Crca-tm^ a Stack is just 

vou pusV. fa 〜 I 

a itL oJto a Stack<string> my Stack = new Stack<string> () 

stadk, \i pushes myStack(PusK)("first in line n ); 

°^ cyr niyStack. Push ( 

kadk one y\ox4n 

sits on W myStack. Push ( 


second in line n ); 
third in line”）； 
last in line 1 ’）； 

=myStack.Peek() 
: myStack.Pop(); 
myStack.Pop(); 


my Stack.Push( 

Qstring takeALook 
O^tring getFirst ： 

❹ string getNext = 

)int howMany = my Stack. Count; 
myStack•Clear(); 

MessageBox.Show( n Peek() returned: 
+ "The first Pop() returned: 

+ "The second Pop() returned: 
+ "Count before Clear() was n 
+ "Count after Clear() is now 



iVhch you pop dh itcrw 
^ -the siadi, you gc-t 
the rwost \rcdCht itcrh 
that was added. 


1 + takeALook + n \n 

+ getFirst + n \n ▼’ 

+ getNext + n \n ▼’ 

howMany + n \n T ’ 

+ myStack.Count); 

© 


you tBr\ 
also use 

Mcv/L'vne 
ms*tcad of \n 
hcv-c, bu*t v/c 
v/3r\icd -the 
todt *to be 
casicv- *to \rcad- 


PeekQ returned: last in line o 

The first PopQ returned: last in line ❹ 

The second PopO returned; third in line ⑩ 
Count before Clear 。 was2 
Count after ClearQ is nowO 


inire 

o 

⑩ 
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flapjacks and lumberjacks 



O 


VOAIT A MIMUTB, SOMETH IM6- '/OU 
HA_，T SH^>WM M6 AMYTHINJ^ I CAM D^> WITH A STA6K ^>12 
A ^U6U6 THAT I CAM ; T DO WITH A UST - THEY JUST SAVE M6 A 
COUPUB Of LIMBS Of COl>B. BUT I CAM ; T 夕 6T AT TH6 IT6MS 
IM TH6 MIDDLE ^>F A STACK 012 A 夕工 6ANJ l>0 THAT WITH 
A LIST P126TTY SASILYi SO WHY W^>UUD I &WB THAT UP 
JUST FO^ A UTTUB CONVB^IBNCB^ 


Don’t worry — you don’t give up anything when you use a 
queue or a stack. 

It’s really easy to copy a Queue object to a List object. And it’s just as 
easy to copy a List to a Queue, a Queue to a Stack.. .in fact, you can 
create a List, Queue, or Stack from any other object that implements the 
IEnumerable interface. All you have to do is use the overloaded constructor 


Lc-t S set up a s-ta^k with 
士 ouv iterhS - ih this C.^sc, d 
o-^ S"tv*ih0s. 


that lets you pass the collection you want to copy from as a parameter. That 
means you have the flexibility and convenience of representing your data with 
the collection that best matches the way you need it to be used. (But remember, 
you’re making a copy, which means you’re creating a whole new object and 
adding it to the heap.) 



Stack<string> myStack = new Stack<string>() 
myStack.Push("first in line"); 
myStack.Push( n second in line n ); 
myStack.Push( n third in line"); 
myStack. Push (’’last in line n ); 


Its easy -to siack 

bo a <\ucuc, t0 ?7 七 

a 1 •此 and 七 tV^e list 


Queue<string> myQueue = new Queue<string>(myStack); 
List<string> myList = new List<string>(myQueue); 



Stack<string> anotherStack = new Stack<string>(myList); 
MessageBox.Show("myQueue has n + myQueue.Count + n items\n 
+ ’’myList has " + myList.Count + n items\n T, 

+ "anotherStack has n + anotherStack.Count + ▼’ items\n , 



f\\\ jfouv vtews 

C.ollctt»oy\s. \ 


myQueue has 4 items 
myList has 4 items 
another&tack has4 items 


OK 


...and you can always use 
a foreach loop to access 
all of the members in a 
stack or a queue! 
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Ei6fU：iS< 


Write a program to help a cafeteria full of lumberjacks eat some flapjacks. Start with the Lumber j ack 
class, filling in the missing code. Then design the form, and add the button event handlers to it. 


RciSCI 

- •* • 

o Here’s the Lumberjack class. Fill in the get accessor for Flap j ackCount 
and the TakeFlap j acks and EatFlap j acks methods. 


name; 
Tame { 



class Lumberj ack { 
private string 

public string Name { get { return name 
private Stack<Flapjack> meal; 

public Lumberjack (string name) { 
this.name = name; 
meal = new Stack<Flapjack>(); 

} 

public int Flapj ackCount { get { // return the count } 

public void TakeFlapjacks(Flapjack food, int howMany) 

// Add some number of flapjacks to the Meal stack 


enum Flapj ack 
Crispy, 
Soggy, 
Browned, 
Banana 



public void EatFlapjacks() { 

// Write this output to the console 


Output 


Ed J s eating flapjacks ▲ 

Ed ate a banana flapjack 
Ed ate a banana -flapjack 
Ed ate a crispy flapjack 
Ed ate a soggy -flapjack 
Ed ate a soggy flapjack 
Ed ate a soggy flapjack 
Ed ate a browned flapjack ▼ 


❺ Build this form. It lets you enter the names of lumberjacks into a text box so they get in the breakfast 
line. You can give the lumberjack at the front of the line a plate of flapjacks, and then tell him to move 
on to eat them using the “Next lumberjack” button. We’ve given you the click event handler for the “Add 
flapjacks” button. Use a queue called breakf astLine to keep track of the lumberjacks. 

■■n 1/Vhe 竹七 he uscv- clicks w /\dd lumbcv-vadk^ add the Mme i» 

// 

name bo 乂 *fco b\rcak-&s-tL'mc 


B ? Breakfast for Lumberjacks 


Lumbefjack name 


Add lumberjack 






Feed a Lumbefjack 

Breakfast line 


2 a 

1. Ed 

2. Billy 

3. Jones 

4. Fred 

5. Johansen 

6. Bobby. Jr. 

This 

listbox 

O Crispy 7 

:: Soggy - 

Browned l 

(•) Banana 1 、 


Add flapjacks 


Ed has 7 flapjacks 

is harmed 
lihC- 








out y/Ka-t should be , 


of at 3 t'W'C- 

UVC 


Next lumbeijack 



七 >wKa*t sKoul 


private void addFlapjacks /Click(. 

if (breakfastLine . Coi^nt == 0) 
Flapjack food; 
if (fcris~ 


return 


Notice how the Flapj ack 
enum uses uppercase 
letters (“Soggy”)，but the 
output has lowercase letters 
(“soggy”)? Here’s a hint to 
help you get the output right. 

ToString () returns a 
string object, and one of its 
public members is a method 
called ToLower () that 
returns a lowercase version 
_of the string._ 


py. Checke< 


This button should dequeue Iumbcvj3£-k> 

dall his EatFlapjadbO, v-edv-aw -the list bo>c. 


tood = Flapjack.Crispy; 
else if (soggy.Checked 

food = Flapj ack.Soggy; 
else if (browned.Checked 

food = Flapj ack.Browned; 

else 

food = Flapj ack.Banana; 


true) 

: 1SPy | I 味七、 

.ggy; 4 

: ed —― true)J 


i\\t 


You’ll r\ccd to add a Rcdvav/ListO method 
to update the lisi boy. with ihc 


p ee lc() veWs a ve-to 

■the -fivst Iwimbevjatk m -tV>e 




Lumberj ack currentLumberjack = breakfastLine.Peek(); 
currentLumberjack.TakeFlapjacks(food, 

P ,' - - - (int) howMany .Value); 

• 七 n'l bu*bto 灼 s will 乙 dll rt. ^^RedrawList () ; The C.oh*tvol is £>dllcd 

t+cve's a W\y\i ： i-t uses a loop. } V^oy/Ma^ and label is dallcd 

This program just prints lines to the console, so you need 
to open the Output window in the IDE to see the output. 


you are here ► 
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exercise solution 



SotjitiPH 


private Queue<Lumberj ack> breakfastLine = new Queue<Lumberj ack>() 

private void addLumberjack_Click(object sender, EventArgs e) { 
if (String •工 sNullOrEmpty(name•Text)) return; 
breakfastLine.Enqueue(new Lumberjack(name.Text)); 
name.Text =""; 

RedrawList (); 





•ihc 


丁 he /?cd\rawListO 
method uses a 
^o\rcac\) loop -to pull 

lu^bcvja^ks out 
queue ahd 

add ol them io 

ihc list box. 


private void RedrawLi"sTi () { 

int number = 1; 
line. 工 terns•Clear(); 

foreach (Lumberj ack lumberj ack in breakfastLine) { 


line.Items.Add(number 
number++; 

if (breakfastLine.Count == 0) 
groupBoxl.Enabled = false; 
nextlnLine•Text =""; 

} else { 


+ lumberj ack.Name) 


TWis 1-P slaWrrt updates 
label m-formation about 
l^Wsi lumkcvjatk m *tKc <\ueue. 


groupBoxl.Enabled = true; 

Lumberj ack currentLumberjack = breakfastLine.Peek(); 
nextlnLine.Text = currentLumberj ack.Name + " has " 

+ currentLumberj ack.Flapj ackCount + " flapjacks"; 


private void nextLumberj ack_Click(obj ect sender, EventArgs e) { 
if (breakfastLine.Count == 0) return; 

Lumberj ack nextLumberjack = breakfastLine.Dequeue(); 
nextLumberjack.EatFlapjacks(); 
nextlnLine•Text =""; 

RedrawList (); 


class Lumberj ack { 

private string name; 

public string Name { get { return name; } } 

private Stack<Flapj ack> meal; 


public Lumberj ack(string name) { 
this.name = name; 
meal = new Stack<Flapjack>(); 


nc TakeFl 外严 ks 

mc*t^od updates 



public int Flapj ackCount { get { return meal.Count; } 

public void TakeFlapjacks(Flapjack food, int howMany) 
for (int i = 0; i < howMany; i++) { 

meal.Push(food); 




public void EatFlapjacks() { 

USCs ^ A\ Console . WriteLine (name + ' 

°°P "to pH»v /： ^ ' C J while (meal. Count >0) { 

1 1 ° u Console.WriteLine(name + " ate a " kT 

+ meal.Pop().ToString().ToLower() + 


iC ihod d 

I i oui 4 -l^, 


Here’s whcv-c the Flapjack um is 

made lov/cv-dasc. Take a and 

uv-c out whaVs oy\. 

s eating flapjacks"); 


flapjack M ); 


} ^cal-PopO \rc*tu\rir>s cllUm, v/hose 7oS*t\riir>jO method is ddlled b> v-c*tuv^ d 
obje 此 whose ToLov/cvO method is tailed -to \rctuvr> a^othev- sivmg object. 
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enums and collections 

Collectioncross 




Across 

3. An instance of a_collection only works with 

one specific type 

6. A special kind of loop that works on iEnumerable<T> 

9. The name of the method you use to send a string to the 
output 

10. How you remove something from a stack 

11. An object that’s like an array but more flexible 

13. Two methods in a class with the same name but different 
parameters are_ 

15. A method to figure out if a certain object is in a collection 

19. An easy way to keep track of categories 

20. All generic collections implement this interface 

21. How you remove something from a queue 


Down 

1. The generic collection that lets you map keys to values 

2. This collection is first-in, first-out 

4. The built-in class that lets your program write text to the 
output 

5. A method to find out how many things are in a collection 

7. The only method in the IComparable interface 

8. Most professional projects start with this 

12. An object that implements this interface helps your list sort 
its contents 

14. How you add something to a queue 

16. This collection is first-in, last-out 

17. How you add something to a stack 

18. This method returns the next object to come off of a stack or 
queue 


you are here ► 
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crossword solution 



Collectioncross Solution 
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9 reading anc 





Save the last byte for me! + 



&o 


AHEAD 


WITH 


CUE 


SHOPPING 


USUHI6KBN 


WIRE. 


T66?UIUU •妹 APS 


JBUUY—BANDA&6S 


I AM 


VBS, 


DSAE, 


Sometimes it pays to be a little persistent. 

So far, all of your programs have been pretty short-lived. They fire up, run for 
a while, and shut down. But that’s not always enough, especially when you’re 
dealing with important information. You need to be able to save your work. In 
this chapter, we’ll look at how to write data to a file, and then how to read that 
information back in from a file. You’ll learn about the .NET stream classes, 
and also take a look at the mysteries of hexadecimal and binary. 


this is a new chapter 
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islands in the stream 


•NET uses streams to read and write data 

A stream is the .NET Framework’s way of getting data in and out of 
your program. Any time your program reads or writes a file, connects 
to another computer over a network, or generally does anything 
where it sends or receives bytes from one place to another, you’re 
using streams. 


Let’s say you have a simple program — a form 
with an event handler that needs to read data 
from a file. You’ll use a Stream object to do it. 


Wkenever you 
want to react 
data from a 
iile or write 
data to a iile, 
you’ll use a 
Stream object. 


input = stream.Read(. 



^dfromth^ 







input contains data read 

from the stream ^ 

you use 3 

StvO object 



…十 the wo^ks 

Wiih ^ ^ di^ily. 



And if your program needs to write data out 
to the file, it can use another Stream object. 



You cay\ use a di-Pfcv-cht 
Stlrcam but the 

p^ro^ss is the sanxe. 
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reading and writing files 


Piffcrewt streams read and write different things 


Every stream is a subclass of the abstract Stream class, and there are a bunch 
of built-in stream classes to do different things. We’ll be concentrating on reading 
and writing regular files, but everything you learn in this chapter will just as easily 
apply to compressed or encrypted files, or network streams that don’t use files at all. 



AFileStream 
object lets you 
read from and 
write to files. 


AMemoryStream 
object lets you read 
from and write 
data to chunks of 
memory. 


ANetworkStream 
object lets you read 
and write data to 
other computers or 
devices on a network. 


AGZipStream 
object lets you 
compress data so 
that it takes up less 
space and is easier to 
download and store. 


things you can do with a stream: 


O K/iB/rg TO THB S71S5AM- 

You can write your data to a stream through a stream’s Write () 
method. 


Streams let you 
react and write 


© ^BAt> F12 夕 M THB ST12BAM^ 

You can use the Read () method to get data from a file, or a network, or 
memory, or just about anything else, using a stream. You can even read 
data from really big files, even if they’re too big to fit into memory. 


data. Use tke 
rigfkt kind oi 
stream lor tke 


O CHAN^B y^ue POSITION UJITHIN THB SmBAM^ 

Most streams support a Seek () method that lets you find a position within 
the stream so you can read or insert data at a specific place. 


data you’re 
working witk. 


you are here ► 
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so much easier 


A FilcStrcam reads and writes bytes to a file 


When your program needs to write a few lines of text 
to a file, there are a lot of things that have to happen: 


❺ 


❺ 


Make sure you add usmj System. |0; *to 




c you 

七 V^a 七 


uses 


s*tvcaw»s. 


o Create a new FileStream object and tell it to write to the file. 



e am 


A FilcSWan, ohly be 
-to ohc -Pile at a 


The FileStream attaches itself to a file. 



e am 


Streams write bytes to files, so you’ll need to convert the string that you 
want to write to an array of bytes. 

69 117 114 101 107 97 33 

, . M1 Eureka! - ^ 

TW,s is caWtd c^odm^, n 

-talk wo\rc about *i*t la 七 ^^ 


丄丄 / 丄丄 4 丄 U 丄丄 U / ^/ OO 

mamm 


0 


2 _ 3 午 5 石 




stvO. 
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reading and writing files 


Write text to a file m three simple steps 

G# comes with a convenient class called StreamWriter that does all of those 
things in one easy step. All you have to do is create a new StreamWriter 
object and give it a filename. It automatically creates a FileStream 
and opens the file. Then you can use the StreamWriter^ Write () and 
WriteLine () methods to write everything to the file you want. 


StreamWriter 
creates and 
manages a 
FileStrea m 
otject lor you 
automatically. 



Use the streamwriter’s constructor to open or create a file. 

You can pass a filename to the StreamWriter () constructor. When you do, the writer automatically 
opens the file. StreamWriter also has an overloaded constructor that lets you specify its append 
mode: passing it true tells it to add data to the end of an existing file (or append), while false tells 
the stream to delete the existing file and create a new file with the same name. 


StreamWriter writer = new StreamWriter(@ M C:\newfiles\toaster oven.txt ", true); 




tells C# 

^Wis as a sV 叫 ^^ out 

estate like 

-tafe ov- 


^ Use the write () and WriteLine () methods to write to the file. 

These methods work just like the ones in the Console class: Write () writes text, and WriteLine () 
writes text and adds a line break to the end. If you include “{0}’’, “{1 }’’ ， “{2}，’, etc., inside the string 
you’re writing, the methods include parameters in the strings being written: “{0}’’ is replaced with the 
first parameter after the string being written, “{1is replaced with the second, etc. 

writer.WriteLine("The {0} is set to {1} degrees .", appliance, temp); 



❺ Call the close () method to release the file. 

If you leave the stream open and attached to a file, then it’ll keep the file locked open 
and no other program will be able to use it. So make sure you always close your files! 


writer.Close (); 


you are here ► 
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write it down 


The Swindler launches another diabolical plan 


The citizens of Objectville have long lived in fear of the Swindler. 
Now he’s using a StreamWriter to implement another evil 
plan. Let’s take a look at what’s going on. Create a new Console 
Application and add this to the Main () method: 

TW,s Ime ^eates tKe Streakier okjd 孙 d 
七 clU rt Were Ac VilUc. 


H ，s probably ho-fc a 
good idea -to 

youir \rooi -Poldcv-, 
youv 七 hoi cvcr> 

lei you do i-fc. So pi^k 
3ho-tlicv- div-c^-to^y ^ou 
"to wiri-tc "to. 



仏 s-tavts with ah & sigh so 
七 4 七 the S-tvcamlVv-i-tcv docs^i 
the W V as the sia^io^ 

escape SC^uCh 匕 c. 




VVv'»*tcLmcO 

adds a y\cv/ Ue 
a-f*tcv- y/vrtm} 
1AM 七 c() sc^ds 
ysi *t^c 七亡此 
r\o C'/ivS 
Imc -feeds 3*b 
{\\t tv\d- 


StreamWriter sw = new StreamWriter(@ n C:\secret_j>lan.txt"); 
sw. WriteLi ne("How I'll defeat Captain Amazing"); 
sw.WriteLine("Another genius secret plan by The Swindler"); 
sw.Write( n I'11 create an army of clones and "); 

sw.WriteLine("unleash them upon the citizens of Objectville. n ); 

string location = "the mall" ; 1 - - Cah you -Piguv-c out wha-ts 

9 oih 9 0|r » >wi-th -the lo^aiioh 

for (int number =0; number <= 6 ； number++) { vav-iablc ih -this dodc? 


sw.WriteLine("Clone #{0} attacks {1}", number, location); 
if (location == "the mall") { location = "downtown 

else { location = "the mall"; } 




• 

•2 

o 

QJ 

E 

參 

w 

(D 


sw.Close (); 


CloscO -frees u\> ^ 

以 c a"d a"Y resources tKc S^ca^iW »s 
us*.^. Uc it%i docs^t yi ⑶ 4 ^ 
do^-t tlosc s-tream. 


TVi'»s »s y/V^a-t *t^c above codt pv-odutes. 


Yo\a use the {} 
withm the text -to 
pdss ih vd\ridbles -fco the 
s*t\rihg beih^ 

[O} is \rcpla^cd by the 
fa\ramctcv- a-f-tev- 
■the sbr\y\^ {/} by -the 
sedohd ； dhd so oh- 


secret_plan - Notepad 


n 


StreamWriter is 
in the System. 10 

namespace, so 
make sure you add 
using System.10; 

to the top of your 
program. 


File Edit Format View Help 


How I J 11 defeat Captain Amazing 

Another genius secret plan by The Swindler 

I J 11 create an army of clones and unleash them ： upon the citizens of Objectville 

Clone #0 attacks the mall 

Clone #1 attacks downtown 

Clone #2 attacks the mall 

Clone #B attacks downtown 

Clone #4 attacks the mall 

Clone #5 attacks downtown 

Clone #6 attacks the mall 


A 


v 
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reading and writing files 



Stream Waiter Magnets 

Suppose you have the code for buttonl—Click () shown 
below. Your job is to use the magnets to build code for the 
Flobbo class so that when the event handler is called, it produces 
the output shown at the bottom of the page. Good luck! 

static void Main(string[] args) { 

Flobbo f = new Flobbo("blue yellow"); 
StreamWriter sw = f.Snobbo(); 
f.Blobbo(f.Blobbo(f.Blobbo(sw), sw), sw); 

} 


sw 


j^riteLine(zap )t 


zap 


i, red orange 


return true; 


sw.WriteLine (zap )； 
sw.Close(); 
return false; 


public bool Blobbo 

(bool Already, StreamWriter sw) { 


public bool Blobbo (StreamWriter sw) { 


sw.WriteLine(zap )； 
za P = "green purple' 



rSt Stre^riter (»macaw.txt -)； 



private string zap; 


public Flobbo(string zap) 
this • zap = zap ； 





Assume all code files have 
using System.10; 
at the top. 


macaw - Notepad - 口 

mm 

File Edit: Format View Help 

blue yellow 
green purple 
red orange 

> 

V 


you are here ► 415 




























































































read it in 



StreamWriter Magnets Solution 

Your job was to construct the Flobbo class from the 
magnets to create the desired output, 
static void Main(string[] args) { 

Flobbo f = new Flobbo("blue yellow"); 
StreamWriter sw = f.Snobbo(); 
f.Blobbo(f.Blobbo(f.Blobbo(sw), sw), sw); 


class Flobbo { 



private string zap; 

public Flobbo(string zap) { 
this.zap = zap; 

} 


pu] 

blic StreamWriter Snobbo() { 

,| 


return new 

StreamWriter("macaw.txt"); 

r 

LLT - 



If you type this into the IDE, 
macaw.txt will be written 
to the bin\Debug folder 
inside your project folder, 
because that's where the 
executable is running. 


Jus*t 3 vcrwmdcv -： y/c pidkcd 
v/civ-d vav-iablc 

灼 amcs Bv\d methods \y\ -these 

puzzles because i-f v/c used 
\rcally good Manxes, the 
puzzle would be "too c3syj 
Do^*t use like "this *m 
you\r Code, 0^? 


Assume all code files have 
using System.10; 
at the top. 


public bool Blobbo(StreamWriter sw) { 

} 

sw.WriteLine(zap); 
zap = "green purple"; 
return false; 


7 



public bool Blobbo 



丁 he BlobboO method 

is ovcvloadcd-it s got 
■Uo d^lava-tiohs with 
di-fWh-t pa^mc-tcvs. 


(bool Already, StreamWriter sw) { 



sw.WriteLine(zap) 
sw.Close() 
return false; 



} else { 


sw.WriteLine(zap); 
zap = "red orange" 
return true; 





■Make suv-c ^ 

^\i\\ 

Output: 


l-f you \rur> -this Code 
-Pv-orw ihc IDE, i 七 
d\rcaics 

m "the bmNpcbug 

-foldcv-. 


macaw - Notepad -口 

mm 

Rle Edit Format View Help 

blue yellow 
green purple 
red orange 

A 

V 

> ■: 

■■■ 1 
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reading and writing files 


Reading and writing using two objects 

Let’s read Swindler’s secret plans with a StreamReader. 
StreamReader works just like StreamWriter, except instead 
of writing a file you give the reader the name of the file to read in its 
constructor. The ReadLine () method returns a string that contains the 
next line from the file. You can write a loop that reads lines from it until its 
EndOf Stream field is true — that’s when it runs out of lines to read: 


Sometimes people play a little fast and loose 
with the word “stream.” A StreamReader 
(which inherits from TextReader) Is a class 
that reads characters from streams. It’s not 
a stream itself. When you pass a filename 
into its constructor, it creates a stream for 
you, and closes it when you call its Close () 
method. It’s also got an overloaded 
constructor that takes a Stream. See how 


_that works?_ 

string folder = / ^ °f Tx ^ 

y V (/ ^'5lroldc\r Chum -to see wha-t o-thev- -foldcv-s you -fmd. 

Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments) 


StreamReader reader = 

new StreamReader(folder + @ n \secret_^plan.txt n ) 
StreamWriter writer = 


Pass i\\t vead 

C：\ Mdtr, 


new StreamWriter(folder + @ n \emailToCaptainAmazing.txt n ); 

\ I his the Swi,aie/s pla,, a,d ^ St … 

to a +.lc will emailed Caftaih 
writer.WriteLine( n To : CaptainAmazing@objectville.net^); 

writer.WriteLine (’’From: Commissioner@objectville.net n ); 


writer.WriteLine(); 


writer.WriteLine("Subject: Can you save the day... again?"); 

/ e 叶 *ty VVvi*tcL*nr\cO method 
v/vi*tcs a bla^k Imc- 

writer.WriteLine("We've discovered the Swindler f s plan :”）； 
while (!reader.EndOfStream) 

string lineFromThePlan = reader. ReadLine () ; ^ 

data ^ 




writer.WriteLine( n The plan -> 


writer.WriteLine(); 

writer. Wri teLine (Can you help us? n ); 
writer.Close (); 


+ lineFromThePlan); 

/\ This loop \rcads a lihC -fv-om 

"tk \rc3clcv* dhd w\ri*tcs i*t 
^ out to the w\ritcv-. 


reader.Close() 



Make suv-c bo ^losc cvev-y 
s-tveam *bha 七 you opcr\, i-f 
youVc just \rcadm5 a -f lic- 

丁 he S*tv"c3inftRcadicv" 3^d £*bro!A/vrtcv" 

oycY\td 七 heiv" ov^ s-tv-ca^s 

you ms*tar\t»a*bcd Call'mj *b^c»v 
CloscO mc-biiods 七 ells {o c\ost 
•tiiosc s-tv-ca^s. 




emailToCaptainAmazing - Notepad 


n 














Pata can go through more thaw owe stream 


One big advantage to working with streams in .NET is that you can have your data 
go through more than one stream on its way to its final destination. One of the many 
types of streams that .NET ships with is the CryptoStream class. This lets you 
encrypt your data before you do anything else with it: 









C\ryp-toSi\rcarw mhevits 

-(*\roirw the 


S-tvcarw ^lass, jus-t 
like the othev- s-tv-cam 


l 0[A ^ic ho^^l 
text -bo a 

Cj 7P&SW. 



bs afr56o^ ( 


" ow 卜 File£i^ 


classes. 


wv-i*tcs 






rSndfr 56 d/\ 





^earCN 



You can CHAW streams. One stream 
can write to anotker stream, wliicli 
writes to anotker stream...often 
encting witk a network or iile stream. 
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reading and writing files 



P00] Puzz]c 


Your job is to take code snippets from 
the pool and place them into the 
blank lines in the program. You 
can use the same snippet more 
than once, and you won’t need 
to use all the snippets. Your goal 
is to make the program produce 
the output shown to the right. 


order - Notepad - 

n l 

mm 

File Edit: Format View 

Help 


West 


a 

East 



South 



North 



That's all folks ： 


V 

< 


> 

1 


class Pineapple { 

const _ d 

public _ 


delivery.txt’ 


{ North, South, East, West, Flamingo } 
public static void Main(string[] args) { 

_ o = new _( "order . txt"), 

Pizza pz = new Pizza (new _(d, true)) 

pz ._(Fargo . Flamingo); 


for 


w 


3; w >= 0; w--) { 

Pizza i = new Pizza 

(new _(d, false)); 


i. 工 daho((Fargo)w); 

Party p 二 new Party(new 
p._(o); 


(d)); 


o' 

o. 


("That's all folks!"); 


0 


class Pizza 
private 一 


public Pizza (■ 


.writer = writer, 


public void 

writer._ 

writer. 


•Fargo f) 


(f )； 

_()； 


class Party 
private 一 


public Party (■ 


reader; 

_ reader) 


.reader = reader; 


public void HowMuch( — 
q._(reader 


q) 
0 ) 


reader. 


0 ; 


Note: each snippet 
from the pool can 
be used more than 
once! 



you are here ► 
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a serious dialog 



Paa] puzzjc 


This Chuh, fspc^i^i^ally, i-ts 



tWs 从 e e— ? 十饮 

如 pvo^v-aw. I*t 6v-cax.cs a 

S tV,at ?asses ^ 

如 Par 切七 • 丁一 «t 'oo ? s 

oassrn^ ea^ ^ 

p-^ ldaU) 州 Aod ^ ? ⑽七 . 


class Pineapple { 

const String d = "delivery. txt"; 

public enillT\ Fargo { North, South, East, West, Flamingo 

public static void Main(string[] args) { 

StreamWriter o = new StreamWriter ("order. txt M )； 
Pizza pz = new Pizza (new StreamWriter {d, true)); 
pz .Idaho (Fargo.Flamingo); 
for (int w = 3; w >= 0; w--) { 

Pizza i = new Pizza (new StreamWriter (d, false)) 
i.Idaho((Fargo)w); 

Party p = new Party (new StreamReader (d) ) ; 

P .HowMuch (o )； 


o . WriteLine ( M That 
o. Close ()； 


s all folks 


class Pizza { ^» 

private StreamWriter writer ； 
public Pizza (StreamWriter writer) { 
this .writer = writer; 

} 

public void Idaho (Pineapple. Fargo f) 
writer . WriteLine (f) ； 

writer . Close (); 


TV^c P' 


^aasske^sa 

⑽ I .#》 


class Party { 

Pav*"ty filass has b private Streair\Reader reader ； 

public Party (StreamReader reader) 
this . reader = reader; 


S-tv-carwRcadcv* -field ； dhd 
its HoWWu 乩 0 method 
\rcads a lihC -P\rorw "that 

dhd whites 

it "to B S"tv-c3rh^/\ri-tc\r. 


public void HowMuch (StreamWriter q) 
q . WriteLine (reader . ReadLine ())； 
reader . Close ()； 


_ 

order - 

Notepad - n 

■ 

File Edit: Format View Help 
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reading and writing files 


Use built-in objects to pop up standard dialog boxes 


When you’re working on a program that reads and writes files, there’s 
a good chance that you’ll need to pop up a dialog box at some point to 
prompt the user for a filename. That’s why .NET for Windows Desktop 
includes objects to pop up the standard desktop file dialog boxes. 


^ ^OpenFileDialog' 
SaveFileDialog 



boxes buili 

like this OpChhlcDialog 
sclcdtihg a -file {p opCh. 


ShowPialogO pops up a dialog box 


Displaying a dialog box is easy. Here’s all you 
need to do: 


Parallels Shared Folders 

Shortcut 
1*35 KB 



Windows 8 
Shortcut 
341 bytes 


File name: 



Browse For Folder 


D 


E Desktop 
Libraries 

> |jp* andrewstellman 
t> I 響 Computer 
[> 兔 Network 
>闻 Control Panel 
Recycle Bin 
t> HFC# 


Make New Folder 


Cancel 


TW»s \s 

foldc^vo>MSCp»aloOy 

dialog 


Open 


D 


Search Desktop fi 


k 

]l! 


andrewstellman 

System Folder 

Network 

System Folder 


HFC# 

File folder 

partyhats 
I JPG File 
353 KB 


Open Cancel 


walk you ihvough 
these steps i h a 


Create an instance of the dialog box object. You can do this in code 
using new, or you can drag it out of the toolbox and onto your form. 




Set the dialog box object’s properties. A few useful ones include Title (which 
sets the text in the title bar ), 工 nitialDirectory (which tells it which 
directory to open first), and FileName (for Open and Save dialog boxes). 


❺ 

o 


Call the object’s ShowDialog () method. That pops up the dialog 
box, and doesn’t return until the user clicks the OK or Cancel button, 
or closes the window. 

The ShowDialog () method returns a DialogResult, which is an enum. 
Some of its members are OK (which means the user clicked OK), Cancel, Yes, 
and No (for Yes/No dialog boxes). 
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dialog boxes are objects too 


Pialog boxes arc just another WiwForms control 

You can add Windows standard file dialog boxes to your program by dragging them to 
your form — just drag an OpenFileDialog control out of the toolbox and drop 
it onto your form. Instead of it showing up as a visual control, you’ll see it appear in 
the space below your form. That’s because it’s a component, which is a special kind 
of nonvisual toolbox control that doesn’t appear directly on the 
form, but which you can still use in your form’s code just like you 
use any other control. 


Wohvisua| W jus-t meahS i-t 
does^i appear oh your 
loirm whch you dv-ag i-t 
ou*t o-p -the "toolbox. 


4 MyWindowsFormsApplication... _ n 


Toolbox 


Search Toolbox 
J Dialogs 
It Pointer 

ColorDialog 

口 Fo I d erB ro ws erD i a I □ g 

H=1 FontDialog 



fi 


▲ 


FontDia 

■t* 


si SaveFileDialog 


you dv^ a 
ou*t o( 

七 he *toolbox. ar\d 
ov\*to youv -fovm, 
i\\t IPS displays 
i 七 m *tKc spade 
ur\dcv-r\ca*tii 
-fov-rw cdi*tov-. 


The k_t_alD’_\redx>vy pvopcvty -the (older 

tliats -fi\rsi displayed wh ⑶ the dialog opens. 



X/ 


openFileDialogl.InitialDirectory = @ n c:\MyFolder\Default\ 
openFileDialogl. Filter = "Text Files (*.txt) | * • txt |’▼ 


The Filtcv- 

P 浐 opeirty le*ts y ou 

he -fil-t C\rs 
show Up Oh 
^ to-t-tor^ o-f -the 
dialog box, su^h as 

+ ’ ▼Comma-Delimited Files (*.csv) |*.csv|All Files (*•*) | ^ -types o( Ucs 

"to show. 

openFileDialogl. FileName = "default file, txt, , 

— 1 TV,cse ? ,o ? c^es -tell ^ 

openFileDialogl. CheckFileExists = true; f i / 4 'isplav 3 ^ cv-v-ov- message tnc 

l LI a ^«lc OV 

openFileDialogl. CheckPathExists = false; \ J ^ cy.*is*t ov\ *tV^c dv-Wc. 

DialogResult result = openFileDialogl.ShowDialog(); 


if (result 


DialogResult.OK) 


OpenSomeFile(openFileDialogl.FileName); 



一 d- 4-S ihe - ^ 
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reading and writing files 


dialog boxes are objects, too 


An OpenFileDialog object shows the standard Windows Open window, 
and the SaveFileDialog shows the Save window. You can display them 
by creating a new instance, setting the properties on the object, and calling 
its ShowDialog () method. The ShowDialog () method returns a 
DialogResult enum (because some dialog boxes have more than two 

buttons or results, so a simple bool wouldn’t be enough). = y? a s ， \/e 03 o je 匕 七 ou*t 

the tool bo 乂 扣 d oy\xo you\r +ov-rw, -the 

七 3idds d Imc like "this *feo you\r 

saveFileDialogl = new SaveFileDialog () ; -Pov-m s l^iiializ^Compo^c^iO r^cihod. 


saveFileDialogl • 工 nitialDirectory = @ n c : \MyFolder\Default \ f, ; 
saveFileDialogl. Filter = "Text Files | * • txt |’▼ 

+ ’ ▼Comma-Delimited Files (*.csv) |*.csv|All Files (*•*) |*.* 
DialogResult result = saveFileDialogl.ShowDialog(); 
if (result == 


DialogResult.OK){ 





The Filtcv p\ropc\r*ty 
is^*t hav-d *to -figure ou*t. 

Jus*t v/ha^s 

between -the I thav-ad*tcv-s 
\y\ *thc s*brmj with what 

shows up m the v/'mdow. 




TV Title fvofcvby lc*b 
you 七 iVis 七七 . 


The ShowDialogO 

wthod pops up 
"the dialog box ahd 
°pchs -the foldcfr 
s ?^icd ih -the 

/hi-tialpjvc^-tov-y 

P^opc^rty. 




— TV SV^P»alo 孚 ) 

SaveTheFile (saveFileDialogl. FileName) ; pcy .i-, C s >wov-k 

■ ? as I 尔獅咖 

TKis assumes iiicvc、a 
mctKod *m *tKc pv-oyam tailed 
SavcTKcFilcO *tKa*t takes a 
^ilev>dme as a pav-ametev-. 


The SaveFileDialog 

pops up -the 
l^/ihdows 

Save as... w dialog box. 


ave As 


© ® ▼ 个 

Ji) « Public ► Public Documents ► 

v C Search Public Documents 

p 

Organize ▼ 

New folder 


i== ▼ 


VT Favorites 

Name 

Date modified 

Type 


■ Desktop 

X Visual Studio 2012 

10/6/2012 4:17 PM 

File folder 



,Downloads 
、 Recent places 

Libraries 
」 Documents 
一 Music 
H Pictures 
3 Videos 

_ Computer 

% Network 

File name: 
Save as type: 

▲ Hide Folders 


^Ch the usc^r chooses a 

i: FilKp^ty. 


Text Files (*.txt) 


Save 





Cha 呼七 ^ w Savc a 
*typc w lis*t us'm^ 
Pil-tcv- pv-opev-ty- 


TV pialo^Rcsul-t 

SV^P»a—) ^\ od 
lets 70 U 代广七 
r 七 ^ 

^ u scv ticked- 
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directory assistance 


Use the built-in File and Pirectory classes 
to work with files and directories 

Like StreamWriter, the File class creates streams that let you work with files behind 
the scenes. You can use its methods to do most common actions without having to create the 
FileStreams first. Directory objects let you work with whole directories full of files. 


things you can do with File: 


o 


© 


❹ 


o 


FINt> OUT IF TUB FlUB 5XISTS- 

You can check to see if a file exists using the 
Exists () method. It’ll return true if it does, 
and false if it doesn’t. 

RBAt> F12^M ANt> UIZIT5 TO THB FlUB. 

You can use the OpenRead () method to get data from 
a file, or the Create () or OpenWrite () method to 
write to the file. 


APP5N0 

TheAppen 


TBXT TO THB FILS. 

ppendAHText () method lets you append 
text to an already created file. It even creates the file 
if it’s not there when the method runs. 

6^BT INFORMATION ABOUT THB FlUB 

The GetLastAccessTime () and 
GetLastWriteTime () methods return the date 
and time when the file was last accessed and modified. 




FiWivf 。 wo\rks jusi like File 

(-P you Yt joihj -to be doihj a \oi o( wo^k with 
I ^ y 伽广•■吵七 io ^ 

the Pile Wo dass usm 9 the File t\ass l s 

七 id methods. 

V" c 心 s docs jus 七 about cvcvythihg the 

hlc dlass docs, cxdcpt you Kav C io 

•t to USC it /ou ^ a hCW o( 

ahd addess its ExistsO OV^ its 

^pchRcadO method m just the same way. 

° hl y di*PWe is File dlass is 仏 

Jo: a small _bdr J adW, 舳 d Filclh-fo is 
be 七七 CV" suited -Po\r bi^ Jobs. 


Things you can do with directory: 

o 


CIS5AT5 A N5UJ t>nzeCT^>12Y^ 

Create a directory using the CreateDirectory () method. All you 
have to do is supply the path; this method does the rest. 

O ^BT A LIST OF THB FlUBS IN A t>U2BCT^>12Y^ 

You can create an array of files in a directory using the 
GetFiles () method; just tell the method which directory you 
want to know about, and it will do the rest. 

@ t>BUBTB A t>U2BCT^>12Y^ 

Deleting a directory is really simple too. Just use the Delete () method. 


p.lc »s a ^ so 
just a sti methods 

■bha 七 le 七 7 ⑽ v/ovk 
^,ics. h\t\^o \s object 

栋 a 七 7 ⑽ msta^atc, 

•,ts mc^ods arc same as 

i\^t ones 70U sec 
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tWeiare no o 

Dumb Questions 


I still don’t get that {0} and {1} thing that was part of the 
StreamWriter. 

A. 

When you’re printing strings to a file, you’ll often find yourself in 
the position of having to print the contents of a bunch of variables. For 
example, you might have to write something like this: 

writer. WriteLine ("My name is ’▼ + name + 
"and my age is ’▼ + age); 

It gets really tedious and somewhat error-prone to have to keep using + 
to combine strings. It’s easier to take advantage of {0} and {1}: 

writer.WriteLine( 

"My name is {0} and my age is {l} n , 
name, age); 

It’s a lot easier to read that code, especially when many variables are 
included in the same line. 

Why did you put an @ in front of the string that contained the 
filename? 

A! When you add a string literal to your program, the compiler 
converts escape sequences like \n and \r to special characters. 

That makes it difficult to type filenames, which have a lot of backslash 
characters in them. If you put @ in front of a string, it tells C# not to 
interpret escape sequences. It also tells C# to include line breaks in 
your string, so you can hit Enter halfway through the string and it’ll 
include that as a line break in the output: 

string twoLine = @"this is a string 
that spans two lines. n ; 

And what do \n and \t mean again? 

Those are escape sequences. \n is a line feed and \t is a 
tab. \r is a return character, or half of a Windows return—in Windows 
text files, lines have to end with \r\n (like we talked about when we 
introduced Environment. NewLine from Chapter 8). If you want 
to use an actual backslash in your string and not have C# interpret it as the 
beginning of an escape sequence, just do a double backslash: \\. 

What was that in the beginning about converting a string to a 
byte array? How would that even work? 


A! You’ve probably heard many times that files on a disk are 
represented as bits and bytes. What that means is that when you write 
a file to a disk, the operating system treats it as one long sequence 
of bytes. The StreamReader and StreamWriter are 
converting from bytes to characters for you—that’s called encoding and 
decoding. Remember from Chapter 4 how a byte variable can store 
any number between 0 and 255? Every file on your hard drive is one 
long sequence of numbers between 0 and 255. It’s up to the programs 
that read and write those files to interpret those bytes as meaningful 
data. When you open a file in Notepad, it converts each individual byte 
to a character—for example, E is 69 and a is 97 (but this depends on 
the encoding...youll learn more about encodings in just a minute). And 
when you type text into Notepad and save it, Notepad converts each of 
the characters back into a byte and saves it to disk. If you want to write 
a string to a stream, you’ll need to do the same. 

If I’m just using a StreamWriter to write to a file, why 
do I really care if it，s creating a FileStreamfor me? 

A. 

If you’re only reading or writing lines to or from a text file in order, 
then all you need are StreamReader and StreamWriter. 
But as soon as you need to do anything more complex than that, 
you’ll need to start working with other streams. If you ever need to 
write data like numbers, arrays, collections, or objects to a file, a 
StreamWriter just won’t do. But don’t worry, we’ll go into a lot 
more detail about how that will work in just a minute. 

； What if I want to create my own dialog boxes? Can I do that? 

Yes, you definitely can. You can add a new form to your 
project and design it to look exactly how you want. Then you 
can create a new instance of it with new (just like you created 
an OpenFileDialog object). Then you can add a public 
ShowDialog () method, and it’ll work just like any other dialog 
box. 

! Why do I need to worry about closing streams after I’m done 
witfTthem? 

A. 

Have you ever had a word processor tell you it couldn’t open a file 
because it was “busy ”？ When one program uses a file, Windows locks 
it and prevents other programs from using it. And it’ll do that for your 
program when it opens a file. If you don’t call the Close () method, 
then it’s possible for your program to keep a file locked open until it 
ends. 
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do it yourself notepad 


c^^rpen your pencil 


.NET has two built-in classes with a bunch of static methods for working 
with files and folders. The File class gives you methods to work with 
files, and the Directory class lets you work with directories. Write 
down what you think each of these lines of code does. 


Code 

What the code does 

if (!Directory.Exists(@"C:\SYP")) { 

Directory.CreateDirectory(@"C:\SYP"); 

} 


if (Directory.Exists(@ M C:\SYP\Bonk")) { 

Directory.Delete(@"C:\SYP\Bonk M ); 

} 


Directory.CreateDirectory(@"C:\SYP\Bonk M ); 


Directory.SetCreationTime(@ M C:\SYP\Bonk M , 
new DateTime(1976, 09, 25)); 


string[] files = Directory.GetFiles(@ M C:\Windows \", 

M *.log ", SearchOption.AllDirectories); 


File.WriteAllText(@ M C:\SYP\Bonk\weirdo.txt ", 

@"This is the first line 

and this is the second line 

and this is the last line"); 


File.Encrypt(@ M C:\SYP\Bonk\weirdo.txt"); 

iK See i-p you tBv\ jucss what this oy\C 

docs—you sccy\ i*t yet- 


File.Copy(@ M C:\SYP\Bonk\weirdo.txt ", 

@"C:\SYP\copy.txt"); 


DateTime myTime = 

Directory.GetCreationTime(@"C:\SYP\Bonk M ); 


File.SetLastWriteTime(@"C:\SYP\copy.txt n , myTime); 


File.Delete(@"C:\SYP\Bonk\weirdo.txt"); 
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reading and writing files 


Use file dialogs to open and save files 
(all with just a few lines of code) 


O 


❺ 


❹ 


You can build a program that opens a text file. It’ll let you make 
changes to the file and save your changes, with very little code, 
all using standard .NET controls. Here’s how: 

Do this 

Build a simple form. ' I 

All you need is a TextBox and two Buttons. Drop the 
OpenFileDialog and SaveFileDialog controls onto 
the form, too. Double-click on the buttons to create their event 
handlers and add a private string field called name to 
the form. Don’t forget to put a using statement up top for 
the System. 10 namespace. 



Here’s a trick to make your TextBox fill up the form. 
Drag a TableLayoutPanel from the toolbox (in 
Containers) onto the form, set its Dock property 
to Fill, and use its Rows and Columns property 
editors to give it two rows and one column. Drag 
the TextBox into the top cell and set its Dock 
property to Fill. Then drag a FlowLayoutPanel 
out of the toolbox into the bottom cell, set its Dock 
to Fill, set its FlowDirection property 
to RightToLeft, and drag the two buttons 
onto it. Set the size of the bottom row in the 
TableLayoutPanel to AutoSize and the top row 
to 100%, and resize the bottom row so that the two 
buttons just fit. Now your editor will resize smoothly! 


Hook the Open button up to the OpenFileDialog object. 

The Open button shows an OpenFileDialog and then uses File . 
ReadAllText () to read the file into the textbox: 


private void open_Click(object sender, EventArgs e) 
if (openFileDialogl.ShowDialog() == DialogResult.OK) 
name = openFileDialogl.FileName; 
textBoxl.Clear (); 

textBoxl.Text = File.ReadAllText(name); 


Simple Text Editor 


This is a TextBox with 
^ult.|i hC set -to 

ahC * set io Fill. 


Clidkihg OpCh shows the 
OpChFilcPialog 匕 oivtvol. 


Open 


Save 


Now, hook up the Save button. 

The Save button uses the File . WriteAllText () method to save the file: 

private void save_Click(object sender, EventArgs e) { 
if (saveFileDialogl.ShowDialog() == DialogResult.OK) { 
name = saveFileDialogl.FileName; 

File.WriteAllText(name, textBoxl.Text); ^ 


The RcadAHTc^tO a^d 
VV/rteAm 乂七 ( ） w'^ods avc ^ 

u\> tKc 

VVc II look di m w'ov-c 

detail m jiAst a ^ pays. 


o Play with the other properties of the dialog boxes. 

冷 Use the Title property of the SaveFileDialog to change the 
text in the title bar. 

冷 Set the 工 nitialDirectory property to have the 
OpenFileDialog start in a specified directory. 

冷 Filter the OpenFileDialog so it will only show text files using the 
Filter property. 


I*f you add d -filtcv-, the 灼 

"the d\rop-dovm lists at ihc botton 
the oycv\ av\d save dialog bo^cs 
will be empty. Try usmj this -filicv- 
K Piles ( 來 "Ut)| 决 . tW. 
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dispose in the proper receptacle 


c^^rpen your pencil 


.NET has two built-in classes with a bunch of static methods for working 
with files and folders. The File class gives you methods to work with 
files, and the Directory class lets you work with directories. Your job 
was to write down what each bit of code did. 


Code 

What the code does 

if ( ! Directory.Exists (@ "C : \SYP" ) ) { 

Directory.CreateDirectory (@ "C : \SYP" ); 

} 

Chcdk i-f {he C ： \Syp -folder e%is*ts. l-f i*t 
doesn't) d\rca*tc i*t- 

if (Directory.Exists (@ M C : \SYP\Bonk" )) { 

Directory.Delete (@ "C : \SYP\Bonk M ); 

} 

Chcdk i-f C ： \Syp\Bohk -folder c%is*ts. l-f 

i 七 does, delete it 

Directory.CreateDirectory (@ M C : \SYP\Bonk M ); 

Cv-ca*te dived*to\ry C ： \Syp\Bor\k. 

Directory.SetCreationTime (@ M C : \SYP\Bonk M , 
new DateTime(1976, 09, 25)); 

Se 七七 he drca*tioh -for -the C ： \Syp\Bor\k 

-folder *to September ZS 

string [] files = Directory.GetFiles (@ M C : \Windows\ " , 

M * .log ", SearchOption.AllDirectories ); 

a lis*t of all -files *m C ： \^Vmdows 七 
泉 log pa*t*tcv*h, mdudir^ all 
-files \y\ ar\y subdired-bory. 

File.WriteAllText (@ M C : \SYP\Bonk\weirdo.txt M , 

@ "This is the first line 

and this is the second line 

and this is the last line"); 

Create a -file called 'Wirdo.*W:” （ i*f i 七 
does / 七 alveady c^ist) *m -the C ： \syp\Bohk 

-folder dr\d y/ri*tc *t^v-cc Irncs of *bo i*t- 

File.Encrypt (@" C : \SYP\Bonk\weirdo.txt" ); 

This is aY\ altcv-^ativc *to us'mj 

a Cv-yp-boStv-cam- 

Take advahtage buil 七 - m lV*mdo>ws 

Chd\ryp*tioh bo Chd\ryp*t *thc -file w weivdo.*bc*t” 
us*m^ lo^cd-*m addou^s d\rcdeh*tials. 

File.Copy (@ M C : \SYP\Bonk\weirdo.txt M , 

@ n C : \SYP\copy.txt" ); 

Copy C ： \Syp\Bohk\y/cirdio.*t^*t -file bo 

C^ypNCopy.-t^-t. 

DateTime myTime = 

Directory.GetCreationTime(@"C:\SYP\Bonk M ); 

Dcdlarc -the myTime variable ar\d srt i*t e<\ual 
bo *thc d\rca*tioh -time C ： \Syp\Bor\k 

-folder. 

File.SetLastWriteTime(@"C:\SYP\copy.txt n , myTime) ; 

Alter las*t w\ri*tc *ti^c dopy.*t>^*t 

-filc *m C ： \syp\ so i-t^s e«\ual bo y/ha*tcvev 
*tir^e is s-bored \y\ *thc myTime variable- 

File.Delete ( @"C:\SYP\Bonk\weirdo.txt"); 

Delete *thc C ： \Syp\Bohk\y/cirdio.*t^*t -file. 
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IPisposable makes sure your objects arc disposed of properly 


A lot of .NET classes implement a particularly useful interface called IDisposable. 

It has only one member: a method called Dispose (). Whenever a class 
implements IDisposable, it’s telling you that there are important things that it needs 
to do in order to shut itself down, usually because it’s allocated resources that 
it won’t give back until you tell it to. The Dispose () method is how you tell the 
object to release those resources. 

You can use the “Go To Definition” feature in the IDE to show you the official G# 
definition of IDisposable. Go to your project and type IDisposable anywhere 
inside a class. Then right-click on it and select “Go To Definition” from the menu. 
It’ll open a new tab with code in it. Expand all of the code and this is what you’ll see: 


Declare an 
otject in a using 
Llock and tkat 
object’s Dispose!) 
itietkoJ is called 
automaticall y^ 


namespace System 


{ 


// Summary : 


A lot o( classes allo^aie v-csouv-^cs, like 

memov-y, -files, Bv\d othev objects. That -they 

•take them ovcv-, do 灼’七 jive back until 

you tell them youVc dov\t wi*th -those vcsouv^cs. 



// 


Defines a method to release allocated resources 


public interface IDisposable 


{ 


// Summary 


// 

// 

// 


Performs application-defined tasks 
associated with freeing, releasing, or 
resetting unmanaged resources. 


void Dispose () 




} 


-tha-t implcmc^-b IDisposable will immediately 
\rdcasc \rcsou\rdcs i"t took ovc\r as sooy\ ds you 
dal I i-fcs DisposcO mrthod. |*t’s dlmos-b dlv/dys *thc las-t 
七 “ you do bc-Povc youVc Aoy\t v/i 七 h -the object 


6(o To PefcW 


al-lo-cate ， verb. 

to distribute resources 
or duties for a particular 
purpose. The pvogTcariiTiiug 
tectTYi was iTTitated at theiv pwje 、 
onager because he allocatei 
dll of the conference rooms for a 
useless TRciucigeifYieut sevniuciT, 
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that’s a lot of vet appointments 


Avoid filesystem errors with usmg statements 


We’ve been telling you all chapter that you need to close your streams. That’s 
because some of the most common bugs that programmers run across when they 
deal with files are caused when streams aren’t closed properly. Luckily, G# gives 
you a great tool to make sure that never happens to you: I Disposable and 
the Dispose () method. When you wrap your stream code in a us in 
statement, it automatically closes your streams for you. All you need to do 
declare your stream reference with a using statement, followed by a 
of code (inside curly brackets) that uses that reference. When you do that, the 
using statement automatically calls the stream’s Dispose () method 
as soon as it finishes running the block of code. Here’s how it works: 




丁 s i^icinney\-is av-c 
di+Wht W ih e ohes ai 
he -top o( youv- todc 




thch a \dU\c o( todt 

withih du\rly bv-a^cs. 


using (StreamWriter sw = new StreamWriter( n secret plan.txt n ) 



sw.WriteLine ( TT How I f ll defeat Captain Amazing 
sw.WriteLine( n Another genius secret plan ”）； 
sw.WriteLine( n by The Swindler n ); 


the usir>9 siaic^i ends, 
七 he DisposcO method o-f ih c 
berng used is v-uk>. 

Every stream has a Dispose () 
method that closes the stream. So 
if you declare your stream in a using 
statement, it will always close itself! 


Thesc 

^ use ihc objed 
Scaled ih ihc 

usih 9 七 Whi 
^bovc like 3y\y 


tw oBe St，— s 
closes stream. 


V*U 灼 


Use multiple usmg statements for multiple objects 

You can pile using statements on top of each other — you don’t need extra sets of curl 
brackets or indents. 

using (StreamReader reader = new StreamReader( M secret_plan.txt")) 
using (StreamWriter writer = new StreamWriter("email.txt")) 


// statements that use reader and writer 

} Vou do^i r^ced io tall CloscO 

sirens bemuse usm 5 扯 0 七 

^\11 tlosc 
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All streams 
implement 

IDisposatle, so 
any time you 
use a stream, 
you skoulct 

ALWAYS 

declare it 
inside a using 
statement. Tkat 
makes sure it’s 
always closect! 





reading and writing files 


Trouble at work 

Meet Brian. He likes his job as a G# developer, but he loves taking 
the occasional day off. His boss hates when people take vacation 
days, so Brian’s got to come up with a good excuse. 



You can help Priaw out by building a program 
to manage his excuses 

Use what you know about reading and writing files to build an 
Excuse Manager that Brian can use to keep track of which excuses 
he’s used recently and how well they went over with the boss. 


^y'»av\ v/3v\*ts *to kcc? 
all of Wis Causes m 
ov^e fladc, so let's lc*t 
W»m a Wdcv -to 
st>vc all -tv^cw. 




d 5 Excuse Manager ^3 

Excuse 

Results 

Last Used 

I Fie date 

My dog has a headache 

□dnl work. Boss knows B don't have a dog. 

Friday . March 15.2{313 

3/15/2(113 5:-[}3: 11 PM 

Folder Save Ooen Random 



TTiC -folder doh-taihS Ohc -toc-t 
file -for cadh exduse. W\\cy\ 
Bv*iah dlidks the Save buttoh, 
■the duvreh 七 excuse is saved out 
■to the -folder. The Opch button 

lets him opch a saved 


Sorwctirwcs B\riahS -fcoo 
laz.y -fco ihihk up av\ 
excuse- LeHs 3dd 3i 
button "fco load up a 
^hdom excuse -fvorw his 

-Poldcv-. 
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brian needs excuses 



Build the Excuse Manager so Brian can manage his excuses at work. 

KciSe 

BUIUD TH5 

This form has a few special features: 

★ When the form’s first loaded, only the Folder button should be enabled 

disable the other three buttons until the user selects a folder. 


* When the form opens or saves an excuse, it displays the file date for the excuse file using 
a Label control with AutoSize set to False and BorderStyle set to Fixed3D. 

* After an excuse is saved, the form pops up an “Excuse Written” message box. 

* The Folder button brings up a folder browser dialog box. If the user selects a folder, 
it enables the Save, Open, and Random buttons. 

* The form knows when there are unsaved changes. When there are no unsaved 
changes, the text on the form’s title bar is “Excuse Manager”. But when the user 
has changed any of the three fields, the form adds an asterisk ( 氺 ） to the title bar. 

The asterisk goes away when the data is saved or a new excuse is opened. 

* The form will need to keep track of the current folder and whether or not the 
current excuse has been saved. You can figure out when the excuse hasn’t been 
saved by using the Changed event handlers for the three input controls. — 


Excuse 

Description: string 
Results: string 
LastUsed: DateTime 
ExcusePath: string 

OpenFile(string) 

Save(string) 


you dag 
a textbox 匕 a 
■foirm 5hd double— 
^luik oh i-fc, you 

a Chdh 9 ed 
hdhdlcir -fov* 

"that -field. 


@ 6125AT5 AN 6XCUSB CLASS AND SlO^e AN INSTANTS O? IT IN TH5 


Now add a cur rent Excuse field to the form to hold the current excuse. You’ll need three overloaded 


constructors: one for when the form’s first loaded, one for opening up a file, and one for a random excuse. 
Add methods OpenFile () to open an excuse (for the constructors to use), and Save () to save the excuse. 
Then add this UpdateForm () method to update the controls (it’ll give you some hints about the class): 



private void UpdateForm(bool chan 
if ( !changed) { 

tcv I this . description . Text = currentExcuse . Description; 

NOT-—so this 
七 Wis tKctks \\ if 


results.Text = currentExcuse.Results; 
lastUsed.Value 二 currentExcuse.LastUsed; 
tring. 工 sNullOrEmpty(currentExcuse.ExcusePath)) 


This pav-ametev ihd'uia-tcs whether 
Ojr hot the has 

卜 11 山 fyou^Powto 
keep o( -this s-tatus. 


/f ileDate . Text = File . GetLastWriteTime (currentExcuse .ExcusePath) . ToString () • 

• lS KOT y^ull OV this • Text = "Excuse Manager"; Double - tkk cm 七 ^ 七 ^bro\s so IPS- fcfWs 

〜咖 Lse ⑽ t idlers ^ you. Uc ^Ua,ale,s ^ 

^ tWc ut do^ols V.II 


else 

this.Text = "Excuse Manager* 
this.formChanged = changed; 


you-to fields or. youv 


And make sure you initialize the excuse’s LastUsed value in the form’s constructor: 


public Forml() { 

InitializeComponent(); 

currentExcuse.LastUsed = lastUsed.Value; 

} 

O MAKE TH5 FOUt>B1^ BUTTON OPBK A POUD512 B12^WS612. 

When the user clicks on the Folder button, the form should pop up a “Browse for Folder” dialog 
box. The form will need to store the folder in a field so that the other dialog boxes can use it. 
When the form first loads, the Save, Open, and Random Excuse buttons are disabled, but if 
the user selects a folder, then the Folder button enables them. 
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reading and writing files 


o MAKE TH5 SAVE BUTTON SAVE TH5 CU12125NT 5XCUS6 T^> A FIU5. 

Clicking the Save button should bring up the Save As dialog box. 


* Each excuse is saved to a separate text file. The first line of the file is the excuse, the second is the 
result, and the third is the date last used (using the Date Time Picker^ ToString () method). 
The Excuse class should have a Save () method to save an excuse out to a specified file. 

* When the Save As dialog box is opened, its folder should be set to the folder that the user 
selected using the Folder button, and the filename should be set to the excuse plus a . txt 
extension. 


The dialog box should have two filters: Text Files (*.txt) and All Files (*.*)• If the user tries to save 
the current excuse but has left either the excuse or the result blank, the form should pop up a 
warning dialog box: 


^ overloaded 

allots 7 寸 ^ a 

/l/lcssayBoy-kov^ 


Unable to save 





O MAKE TH5 ^PBN BUTTON ^>P5N A SAVED 5X6US5- 

Clicking the Open button should bring up the Open dialog box. 



* When the Open dialog box is opened, its folder should be set to the folder that the user 
selected using the Folder button. 

* Add an Open () method to the Excuse class to open an excuse from a given file. 

* Use Convert. ToDateTimeO to load the saved date into the Date Time Picker control. 

* If the user tries to open a saved excuse but the current excuse hasn’t been saved, it pops up this 
dialog box: 



Show d Ycs/^lo didlo^ \)o% by us'rn^ 

七 k overloaded McssajcBo>c.ShowO 

method lets you spe^i-fy *thc 

/WcssagcBoxBut*tohsYcs/Vo f-f 

the usev d\Cks hl Q) thch Shov/O VC-tuVhS 

DialogRcsultNo. 


FINAUUY, MAKE TH5 IZANt>^>M GXCUSB BUTTON U?AD A 

RANDOM excuse. 

When the user clicks the Random Excuse button, it looks in the excuse folder, chooses one of 
the excuses at random, and opens it. 


* The form will need to save a Random object in a field and pass it to one of the 
overloaded constructors of the Excuse object. 

★ If the current excuse hasn’t been saved, the button should pop up the same warning 
dialog box as the Open button. 
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exercise solution 



Build the Excuse Manager so Brian can manage his excuses at work. 


内 jRciSe 

©PLjitlOH 


private Excuse currentExcuse : 
private string selectedFolder =" 
private bool formChanged = false; 
Random random = new Random(); 


new Excuse (); 



TV (ornx uses -fields *to short duvvcrrt 5 从 use 

bo seized -foldcv- a^d v/k 七 kv 

ov 竹。七七 he 6 uvvwt c%dusc lias ar\d "to keep a 

Rd^dom object -fov" Random 6 %£-usc buttoh. 


private void f older— Click (object sender, EventArgs e) { 

folderBrowserDialogl.SelectedPath = selectedFolder; 
DialogResult result = folderBrowserDialogl.ShowDialog() 
if (result == DialogResult.OK) { 

selectedFolder = folderBrowserDialogl.SelectedPath; 
save.Enabled = true; 
open.Enabled = true; 
randomExcuse.Enabled = true; 



sclented a W 伏， 


以产 vaSCV — Jfoldcv 

孙 d 如 ^ WcS 

WtW s . 


The tv/o vcv-tidal bav-s OR—-this is -tv-uc i-P 

dcsd\rip*tio^ is empty OR v-csults is empty. 


private void save_Click (object sender, EventArgs e 

if (String • 工 sNullOrEmpty(description.Text) || 〔 String.IsNullOrEmpty(results•Text)) { 

MessageBox.Show("Please specify an excuse and a result ", 

"Unable to save ", MessageBoxButtons.OK, MessageBoxIcon.Exclamation); 

return; ^^^ 讪饮 C the At 的辦 


saveFileDialogl • 工 nitialDirectory = selectedFolder; 
saveFileDialogl.Filter = "Text files (*.txt)|*.txt|All files ( 
saveFileDialogl.FileName = description.Text + ".txt"; 
DialogResult result = saveFileDialogl.ShowDialog(); 
if (result == DialogResult.OK) { 

currentExcuse.Save(saveFileDialogl.FileName); 

UpdateForm(false); 

MessageBox.Show("Excuse written"); 


' "cre s wncv-c the -riltev-s av* 
^ \oy -the Save As dialog. 


)1 


TK ' S . H 十 sc irowto s h ow up 

u%f ,lcso /7^ d ^ 

thc bottom of the Save dialoa box ： 

r: ^ 5 ^ - 


private void open_Click(object sender, EventArgs e) { 

if (CheckChanged()) { 

openFileDialogl • 工 nitialDirectory = selectedFolder; 

openFileDialogl. Filter = "Text files (*.txt) | * . txt | All files (*•*) | 
openFileDialogl.FileName = description.Text + ".txt"; 

DialogResult result = openFileDialogl.ShowDialog(); tv i D ix 

if (result == DialogResult. OK) { Use tKc Pialo^Kcsul*t 

currentExcuse = new Excuse (openFileDialogl. FileNameN vc*tuvv>cd by and 

UpdateForm (false) ; dialog bo%cs *to r^dke suV-C you or\Vj 

} } o^tv\ ov save i-f *tKc usev- disked 

I O^t Cav>dcl 


private void randomExcuse 一 Click (object sender, EventArgs e) { 
if (CheckChanged()) { 

currentExcuse = new Excuse(random, selectedFolder); 
UpdateForm(false); 
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private bool CheckChanged() { 

if (formChanged) { 

DialogResult result = MessageBox.Show( 

"The current excuse has not been saved. Continue ?", 

"Warning ", MessageBoxButtons.YesNo, MessageBoxIcon•Warning); 
if (result == MalogResult. No) 


return false; 


return true; 


Mcssa^cBovc Siioy/O also 代七价⑽ a 

Pialo^Rcsul*t evMA 你 Aa 七 v/e da 朽 diictk. 


private void description 一 TextChanged (object sender, 
currentExcuse.Description = description.Text; 
UpdateForm(true); 


EventArgs e) 


private void results 一 TextChanged (object sender, EventArgs e) 
currentExcuse.Results = results.Text; 

UpdateForm(true); 


private void lastUsed_ValueChanged (object sender, EventArgs e) 
currentExcuse.LastUsed = lastUsed.Value; 

UpdateForm<(trueT^_^Pass'mj tvuc io UpdatcFov-mO id Is ii 

} j us 七你 avk 七 he -Pov-m as bu-t 

class Excuse { ⑽ Upd 如 ^ i 吁 uUo 士 ok 

public string Description { get; set; } 
public string Results { get; set; } 
public DateTime LastUsed { get; set; 
public string ExcusePath { get; set; 

public Excuse() { 

ExcusePath =""; 


rtcvc avc i\\t 七 Wee 
Cha 呼 d cvcw 七 V^andlcvs 
^ 七 

-f ields ov\ *tV^c ^o\rw. I< ^ 

oJf 払 cm a 代 

栋 a 七 excuse 

has so -f iv-s-t 

Y/C update 

av>d ^ 
tall U^da-bcFovwO, add 
i\\c as 七 chsk *to 

-fov-ws *tvtle bar, a 灼 d set 

*to br^ 




public Excuse(string excusePath) { 

OpenFile(excusePath); 

} 

public Excuse(Random random, string folder) { 

string[] fileNames = Directory•GetFiles(folder, n *.txt n ) 
OpenFile(fileNames[random.Next(fileNames.Length)]); 




]/\lt made suv-c *to use a us— 
如七加以七 cvev-y tiw'C >wc 

o\>ey\ed a stream. TV>at ^ 
ou v hies Will always be ^<> scd - 


private void OpenFile(string excusePath) { 
this.ExcusePath = excusePath; 
using (StreamReader reader = new StreamReader(excusePath)) 
Description = reader.ReadLine(); 

Results = reader.ReadLine(); 

LastUsed = Convert.ToDateTime(reader.ReadLine()); 


public void Save(string fileName) { 

using (StreamWriter writer = new StreamWriter(fileName)) 

{ 

writer.WriteLine(Description); 
writer.WriteLine(Results); 
writer.WriteLine(LastUsed); 



Wcxts, Y/V^cvc ttc 必•，吒 
domes rn. Wc 

dcdlaved ttc 

ms»dc a usm^ sb 七 ewe 此二 
Vts CloscO method called 
^ov-us auWat^allv! 


Did you dal I Las-tUscd ToStv-m^O? Rcmcmbcv-, lVv-i*tcL'mcO dal Is i 七 au*toma*tidally| 
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i J m the decider 


Writing files usually involves 
making a lot of decisions 

You’ll write lots of programs that take a single input, maybe from a 
file, and have to decide what to do based on that input. Here’s code 
that uses one long i f statement — it’s pretty typical. It checks the 
part variable and prints different lines to the file based on which 
enum it uses. There are lots of choices, so lots of else ifs: 


enum BodyPart 
Head, 
Shoulders 
Knees, 
Toes 



Here’s an enum — well "to dompave 

a variable ajams-t cath o( -the -fouv 
membev-s a 灼 d v/v-itc a Tmc bo 七 he 

StvcamlVviicv dcpcr>dir>5 oy\ whidh ov\t ii 
matdlics. iVdl also v/v-iic some 七 Vmg di-P-Pcv-c^t 
i-f o( therw rwatdh. 


private void WritePartlnfo(BodyPart part, StreamWriter writer) { 
if (part == BodyPart.Head) 

writer.WriteLine ("the head is hairy"); 
else if (part == BodyPart.Shoulders) - 

writer.WriteLine("the shoulders are broad"); r .c/ \ 

yjc use a schdVcUe 

else if (part == BodyPart. Knees) - 七 yic cr\d 

writer.WriteLine("the knees are knobby"); r u? _ 七”七 V ㈣ 七 
else if (part == BodyPart. Toes) ^ _ J 二二 [o^bcm]), ovcv- ^Y\d ovcv-. 


writer.WriteLine("the toes are teeny"); 
else __ 


writer.WriteLine("some unknown part is unknown"); 





What sort of things can go wrong when you write code that 
has this many if/else statements? Think about typos and 
bugs caused by brackets, a single equals sign, etc. 


436 Chapter 9 











reading and writing files 


Use a switch statement to 
choose the right option 

Comparing one variable against a bunch of different values is 
a really common pattern that you’ll see over and over again. 
It’s especially common when you’re reading and writing 
files. It’s so common, in fact, that G# has a special kind of 
statement designed specifically for this situation. 


The\re’s ⑽ 七 hi% aboui d swi-tdh 
thai’s spcdi-Pidally 
v*da*tcd "to -files. Ijus-t d useful 
C 养 "tool -tha-t v/c da 灼 use hcv-c. 



A switek 

statement 


A switch statement lets you compare one variable against 
many values in a way that’s compact and easy to read. Here’s 
a switch statement that does exactly the same thing as the 
series of if/else statements on the opposite page: 

VWIl sta^rt ^ sWyieM keyv/ovd ^lloy/cd 
by i\\t variable aomj *to be domfa^red 


compares ONE 
variable against 

MULTIPLE 

possible values. 


ajamst a possible values 

private voi^/WritePar"Elnfo (BodyPart part, StreamWriter writer) 

{ 


Evc\ry dasc ehds 
with W b\rcak / ； so 
C 养 khows wheve 

O^c (tasc cr\ds 3 y)d 
the hext be^ihs. 

Y^u c^y\ also ehd a 
Use with Vctu\rh ；； 
the f\rog\ra^ will 
^orwpilc as loh^ as 
ho way -fov* 
oy\t case -to +all 
tlurougli^ -to the 

OhC. 


} 




switch (part) 

case BodyPart.Head: 

writer . WriteLine ( TT the head 

break; 

case BodyPart.Shoulders : 
writer . WriteLine ( TT the 

break; 

case BodyPart.Knees : 

writer . WriteLine ( TT the 

break; 

case BodyPart.Toes : 

writer . WriteLine ( TT the 

break; 
default: 


is hairy n ) 



The body o-P -the switch 
七七 is a scirics 
-that to^^t 

whatever -follows -the 
swiM keywovd agaihst 
a pavtidulair value. 


shoulders are broad n ) 


break 




Swrbih s-tatcmchts cv\d 
with ^ "d^auli" blo^k that 
yts hohe o*f the 

oiheir cases avc mashed. 


Eadh o( these dases do^sis-ts o-f -the dasc keyv/ov-d 
-followed by the value *to dompav-c a dolo 灼 . 

that is a scv-ics o( s*ta*tcmc^*U -Pollov/cd 
by %reak;”. Those v/ill be c^cdu-tcd i-f 

•the dase mashes *thc dompav-iso^ value- 
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asleep at the sw/fcA? 


Use a switch statement to let your deck of 

cards read from a file or write itself out to one Tke switch 


Writing a card out to a file is straightforward — just make a loop that writes the name 
of each card out to a file. Here’s a method you can add to the Deck object that does 
exactly that: 

public void WriteCards(string filename) { 

using (StreamWriter writer = new StreamWriter(filename)) { 

for (int i = 0; i < cards.Count; i++) { 

writer.WriteLine(cards[i].Name); 

} 


But what about reading the file in? It’s not quite so simple. That’s where the switch 
statement can come in handy. 

_ T \ c T M sia^h with a 

Suits suit ； agaihst This switch 

P statemchi is called a method 

switch (suitstring) ( that has a suit 如 a 如 


case "Spades" : 

suit = Suits.Spades 
break; 

case "Clubs" : 

suit = Suits.Clubs 
break; 

case "Hearts" : ^ - 


m 3 . 


statement lets 
you test one 
value against a 
tuncli oi cases 
and execute 
ctiiierent 
statements 
ctepenctingf on 
wkick one it 
matekes. 



of *tV>csc dasc I’mcs domfaves 
some value a^ams*t value m 

i\yt sy/rtdh Uc. W 
\i c%cdu*tcs dll of -folloy/m^ 

s*ta*bcmc^*b wrrbil * 七“如 a Weak. 


suit = Suits.Hearts; 
break; 

case "Diamonds" : 

suit = Suits.Diamonds 
break; 
default: 


The default lihe ai the ehd. 
If ^ohc of the tascs matdh, i\\c 
s*tatcmch*b a-Ptcv* the dc-fault get 

ihs*tcad. 


MessageBox. Show (suitstring + n isnl a valid suit! n ) 
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Add aw overloaded PeckO constructor that 
reads a deck of cards m from a file 


You can use a switch statement to build a new constructor for the Deck 
class that you wrote in the last chapter. This constructor reads in a file and 
checks each line for a card. Any valid card gets added to the deck. 


There’s a method that you can find on every string that’ll come in handy: 
Split () . It lets you split the string into an array of substrings by passing it 
a char [ ] array of separator characters that it’ll use to split up the string. 


public Deck(string filename) { 
cards = new List<Card>(); 

using (StreamReader reader = new StreamReader(filename)) 


This I me "tells C 养 "fco spli-fc the 
hCxtCa\rd stv-ihg us'rn^ a 
办 a scpa\ra-to\r 


Tha-fe splits the stv-rng u £ix 
D_arwohds” 'm'fco the avvay 
{ U Diar,o ， ds W }. 


while (!reader.EndOfStream) { 
bool invalidCard = false; 
string nextCard = reader.ReadLine(); 
string[] cardParts = nextCard.Split(new char[] { ' ' }); 



Values value = Values.Ace; 


switch (cardParts[0]) { 


case 

"Ace": 

value — 

Values.Ace; break; 

case 

"Two": 

value = 

Values.Two; break; 

case 

"Three 

" : value 

=Values.Three; break; 

case 

"Four" 

: value = 

= Values.Four; break; 

case 

"Five" 

: value = 

=Values.Five; break; 

case 

"Six" : 

value — 

Values.Six; break; 

case 

"Seven 

" : value 

=Values.Seven; break; 

case 

"Eight 

" : value 

=Values.Eight; break; 

case 

"Nine" 

: value = 

=Values.Nine; break; 

case 

"Ten" : 

value = 

Values.Ten; break; 

case 

"Jack" 

: value = 

=Values.Jack; break; 

case 

"Queen 

" : value 

=Values.Queen; break; 

case 

"King" 

: value = 

=Values.King; break; 

default : invalidCard = true; break; 



This swi-Uh siatcmch-t 
亡 he 亡 ks -Piv-s£ wo^*d 

^ *thc lihe io see i-f i£ 
^a-tdhes a value, /-f *,£ 
docs, -the Hjht value 

* s 5 ss ' 3 hC ^ *to £hc 

value vaHable. 


Suits suit = Suits.Clubs; 

switch (cardParts[2]) { 

case "Spades" : suit = 
case "Clubs" : suit = 
case "Hearts" : suit = 
case "Diamonds" : suit 
default : invalidCard 

} 

if (!invalidCard) { 

cards.Add(new Card(suit 


Suits.Spades; break; 
Suits.Clubs; break; 

Suits.Hearts; break; 

=Suits.Diamonds; break; 
=true; break; 

value)); 


Wt Ao -the same -fov 

-the y/ovd Imc 

r" do^vcv-*b 

\ "bo d suit 
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AUU THAT COt>B JUST lO RBAD IM 
om SIMPUB 6ARD? 韻 T，S WAY TOO MU6H 
W^Rkli VO NAT IF MY HAS A WH^U6 BUN6H 

FI BUDS AND VAUUBS? ARB Y^U TBUUINd^ ME 工 
N5BD T^> WRITB A SWITCH STATBMBNT SfKCM 

O? THBM? 


There’s an easier way to store your objects in 
files. It’s called serialization. 


Instead of painstakingly writing out each field and value to 
a file line by line, you can save your object the easy way by 
serializing it out to a stream. Serializing an object is like 
flattening it out so you can slip it into a file. And on the 
other end, you can deserialize it, which is like taking it out 
of the file and inflating it again. 


0^, just *to dome c\t^y\ s also d method td\\td 

^.Pa^O^youll Ica^ about \i m ChapW I 午一 that 

y/ill do^vcv-t -the stv^3 u Spadcs ; -to value Suits. 

Spades. But scvializ^tio^ s-till makes a lot rnort sense 
heve. Vou II -f md out i^ovc about … 





reading and writing files 


What happens to an object whew it's serialized? 

It seems like something mysterious has to happen to an object in order to copy 
it off of the heap and put it into a file, but it’s actually pretty straightforward. 


o Object on the heap 



O Object serialized 



When you create an instance of an 
object, it has a state. Everything 
that an object “knows” is what makes 
one instance of a class different from 
another instance of the same class. 


When G# serializes an object, it saves 
the complete state of the object, so 

that an identical instance (object) can be 
brought back to life on the heap later. 


TV's 






- variable values 

⑽ 00101 

十 h 3 w •从 a liiilc 
fo ihc CLR ^ 

l，k . C ihc o-P ihc objed 
ahd c ^ h of its fields). J 


file.dat 


Object on the heap again 


o And later on... 

Later — maybe days later, and in a 
different program — you can go back to 
the file and deserialize it. That pulls 
the original class back out of the file 
and restores it exactly as it was, with 
all of its fields and values intact. 
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save the cheerleader 


Put what exactly ]S aw object's 
state? What needs to be saved? 

We already know that an object stores its state in its fields. So when an 
object is serialized, every one of those fields needs to be saved to the file. 

Serialization starts to get interesting when you have more complicated objects. 
Chars, ints, doubles, and other value types have bytes that can just be written 
out to a file as is. But what if an object has an instance variable that’s an object 
reference? What about an object that has five instance variables that are object 
references? What if those object instance variables themselves have instance 
variables? 

Think about it for a minute. What part of an object is potentially unique? Imagine 
what needs to be restored in order to get an object that’s identical to the one that 
was saved. Somehow everything on the heap has to be written to the file. 



e 办 货 e 它 n 

What has to happen for this Car object to be saved so 
that it gets restored back to its original state? Let’s say 
the car has three passengers and a 3-liter engine and 
all-weather radial tires...aren’t those things all part of the 
Car object’s state? What should happen to them? 


UeCa'r 

^7^ ^ 


V^a^ s 






The EhjihC object is 
^ pv-iva*tc. Should i*t be 

saved, -too? 


-j-j 

^ objects Kas *«-ts 

*to 

objats. Po i^ost y^ttd 
■to be saved, -too? 
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reading and writing files 


Whew aw object is serialized, all of the 
objects it refers to get serialized, too.. 



...and all of the objects they refer to, and all of the objects those other objects refer to, 
and so on and so on. But don’t worry — it may sound complicated, but it all happens 
automatically. G# starts with the object you want to serialize and looks through its 
fields for other objects. Then it does the same for each of them. Every single object 
gets written out to the file, along with all the information G# needs to reconstitute it 
all when the object gets deserialized. 


HSS 

L 气 oV)\C 土 


op i\\t fields of 
objcdl is 
七^七 

: ams 七 v/ 。 po^ 

so C# 』 乙 . 

i 仫 serially 0 b*^ C y 

的 ^ 0 o-P *thc -two Dog objects 

has rc-fcrchdcs *to a DojjylP 
object av\d a Collar object. 
They’ll heed -to get serialized 


^°9 ob〆 i 

Po W7 lP W Collar a ： e ^ -d 

代 W 加 衅出. 


Breed.Beagle 
4 years old 
32 pounds 
14 〃 tall 


Breed.Mutt 
6 years old 
18 pounds 
11 〃 tall 


This whole group of 
connected objects is 
sometimes referred 
to as a graph. 
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Serialization lets you read or write a 
whole object graph all at once 

You’re not just limited to reading and writing lines of text to your files. You can 
use serialization to let your programs copy entire objects to files and read 
them back in.. .all in just a few lines of code! There’s a tiny amount of prep work 
you need to do — add one [ Serializable] line to the top of the class to 
serialize — but once you do that, everything’s ready to write. 

You'll need a PmaryFormatter object 

If you want to serialize an object graph, the first thing you do is create an instance 
of BinaryFormatter. It’s really straightforward to do — and all it takes is one 
line of code (and an extra using line at the top of the class file). 


It’s quick to copy 

an object out to 
a iile or read it 
in irom one. You 
can serialize or 
deserialize it. 


using System.Runtime.Serialization.Formatters.Binary; 


BinaryFormatter formatter = new BinaryFormatter(); 

The Filc.C^icO method 

Now just create a stream and read or write your objects = 气 。 a 如 . ‘ dah 

°P Ch ^ ^tsi.h 9 OhC USih 9 File. 

Use the Serialize () method from the BinaryFormatter object to write anv^, CpChl/V\r'rtcO. 
object out to a stream. ^ ^ - - 

using (Stream output = File.Create(filenamestring)) { 

formatter.Serialize(output, objectToSerialize); 

} TV>c Scrialt^O me 七 W takes 

ar>d y/v-rtes *rt ou*t *to a 

stream. TKaVs a Wole 1 。七 caster 

And once you’ve got an object serialized out to a file, use the BinaryFormatter 七 build 3 method bo >wv*rbc ft 
object’s Deserialize ( ) method to read it back in. The method returns a , 1 Cl 

reference, so you need to cast the output so that it matches the type of the reference 
variable you’re copying it to. 



using (Stream input = File.OpenRead(filenamestring)) { 

SomeObj obj = (SomeObj)formatter.Deserialize(input) 

} you use Pcscvializ^O *to vead 

( objed-t W om a s-tveam, doY\ l i 

^ {jo £.as*b vetuv^ value *to 

type <^c object youVc veadm^. 
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reading and writing files 


If you want your class to be serializable, mark 
it with the [Serializable! attribute 


An attribute is a special tag that you can add to the top of any G# class. It’s how G# stores 
metadata about your code, or information about how the code should be used or treated. When 
you add [Serializable] to the top of a class just above the class declaration, you’re 
telling G# that your class is safe for serialization. And you only use it with classes that include fields 
that are either value types (like an int, decimal, or enum) or other serializable classes. If you 
don’t add the attribute to the class you want to serialize, or if you include a field with a type that 
isn’t serializable, then your program will have an error when you try to run it. See for yourself .. 


o 


Create a class and serialize it. 



th 


Attributes are 
a way to add 
information to your 
class or member 
declaration. The 
[Serializable] 
attribute is in 
the System 
namespace. 


Let’s serialize Joe so we can keep a file that knows how much money he’s got in his pocket even after you 
close your program. Open the “Fun with Joe and Bob” project from Chapter 3 and update the Guy class: 


[Serializable] 一"、 /ou ^cd io add ih\s aUv-ibulc io top 

class Guy { d dass ih o\rdc\r b> scv-ializ^ it- 


Next, add a “Save Joe” button and a “Load Joe” button to the form. Here’s code for their event handler 
methods to serialize the Joe object to a file called Guy_Jile.dat and read it back: 



using System.10; 

using System.Runtime.Serialization.Formatters.Binary; 


private void saveJoe_Click(obj ect sender, EventArgs e) 


You 11 heed these two 
lihCS. The ohC is 
the -file ahd stream 


using (Stream output = File.Create( M Guy_File.dat")) { 

BinaryFormatter formatter = new BinaryFormatter(); 


methods, dhd sedohd 
is -for sc\rialiia*tioh. 


formatter.Serialize(output, joe); 

} 

} 

private void loadJoe_Click(obj ect sender, EventArgs e) 

{ 

using (Stream input = File.OpenRead( M Guy_File.dat")) { 

BinaryFormatter formatter = new BinaryFormatter(); 
joe = (Guy)formatter.Deserialize(input); 

} 

UpdateForm(); 


Run the program and play around with it. 


n — 


Fun with Joe and Bob 



Joe has S5Q 
Bob has $100 
The bank has $10-D 


Give $10 to 

Joe 

Receive $5 
from Bob 


Joe gives $10 
to Bob 

Bob gives S5 
to Joe 


Save Joe 

Load Joe 


If Joe had two hundred dollars saved up from his transactions with Bob during your time running the 
program, it would be a pain to lose all that money just because you needed to exit. Now your program can 
save Joe out to a file and restore him whenever you want. 


What happens if you delete Guy_File.dat from the bin/Debug folder and then click LoadJoe? 
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I like milk on my serial 


Let's serialize and deserialize a deck of cards 



Take a deck of cards and write it out to a file. G# makes 
serializing objects really easy. All you need to do is 
create a stream and write out your objects. 

O CJZBATB A NBVJ PROJECT ANt> At>t> THB t>BCK ANt> CA12t> CUASSBS^ 

Right-click on the project in the Solution Explorer and choose Add^Existing Item, and add the 
Card and Deck classes (and the Suits and Values enums and CardComparer_bySuit and 
CardComparer_byValue interfaces) you used in Go Fish! in Chapter 8. You’ll also need to add the two 
card comparer classes, since Deck uses them. The IDE will copy the files into the new project — make sure 
you change the namespace line at the top of each class file to match your new project’s namespace. 


O MAISK THB CUASSBS SBRIAUZABUB^ ^ ^ f 

Add the [Serializable] attribute to both classes you added to the ^° U ° h ^ 

project. this, C 莽 woh *t let 

^~^ you scHaliz^ ihc 

A classes io a -Pile. 

Q AV>V> A COUPUB OF US5FUL MBTH^>t>S TO TUB PO 訊 • 

The RandomDeck method creates a random deck of cards, and the 
Deal Cards method deals all of the cards and prints them to the console. 

TWis ayv 


dc6k adds some 

v-a^om 6ards to \i ^ 
七 Card ^lass W 恤 

last 


Random random = new Random(); 
private Deck RandomDeck(int number) { 

Deck myDeck = new Deck(new Card[] { }); 

for (int i = 0; i < number; i++) 

{ 

myDeck.Add(new Card( 

(Suits)random.Next(4), 

(Values)random.Next(l f 14))); 



return myDeck; 


private void DealCards(Deck deckToDeal 
Console.WriteLine(title); 
while (deckToDeal.Count > 0) 


string title) 




Card nextCard = deckToDeal.Deal(0) 
Console.WriteLine(nextCard.Name); 


Console.WriteLine(" 


I / ^ ^ihod deals ^ 

^ 心 ^ds ^ ^ ih c 

dedk 扣 d pHhis ii {o 

the ^OhSolc^ 
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Don't forget to open the IDE's Ouptut window to 
view the console output from a WinForms program 






Flip \>atk a 

page -to sec 
the us'mj 
s-tatcmc^-b 
•to add *to 
七 he -PoV-m. 



reading and writing files 

OK, PI25P VJOIZ^S MN5 … NOUJ S5I2IAUZB THAT t>BCK^ 


Start by adding buttons to serialize a random deck to a file and read it back. Check the 

console output to make sure the deck you wrote out is the same as the deck you read. . . \ 

TV^c Bmav-YFov-mawv- object 

private void buttonl_Click (object sender, EventArgs e) { w3V"kcd W»tn 

Deck deckToWrite = RandomDeck(5); 

using (Stream output = File.Create("Deckl.dat") ) { 

BinaryFormatter bf = new BinaryFormatter(); 
bf.Serialize(output, deckToWrite); 


如 ScnaVi^Wc 
tW»s cast a VtcV 

•^CS rt out a stream usn，5 

■ts ScnaVi^cO mc-bv^od. 


y/ri 


DealCards (deckToWrite, "What 工 just wrote to the file ’，） 


private void button2_Click(object sender, EventArgs e) { 

using (Stream input = File.OpenRead("Deckl.dat M ) ) { 

BinaryFormatter bf = new BinaryFormatter(); 

Deck deckFromFile = (Deck)bf.Deserialize(input); 
DealCards (deckFromFile A "What 工 read from the file ，'）； 


丁 he 

IWializ^O method \rctu\rhs 
ah whidh is jus£ the 

that f vc^y C# 

objedt ihhc\riis whidh is 

why we heed -to dasi \i io a 

Veck objedt 


S5l2IALIZe A BUNCH OF t>BCKS TO TUB SAMB FIL5 - 

Once you open a stream, you can write as much as you want to it. You can serialize as 
many objects as you need into the same file. So now add two more buttons to write out a 
random number of decks to the file. Check the output to make sure everything looks good. 


You scv-*»aV»z^ 

b> 

same s-tveaw- 


private void button3_Click(object sender, EventArgs e) { 

using (Stream output = File.Create("Deck2.dat") ) { 

BinaryFormatter bf = new BinaryFormatter(); 
for (int i = 1; i <= 5; i++) { 

Deck deckToWrite = RandomDeck(random.Next(1 f 10)) 
bf.Serialize(output, deckToWrite); 

DealCards (deckToWrite, "Deck #，’ + i + ' 


Kotidc how the I'mc that 

V~c3cls 3 sih^lc dttk -f\ronr\ 

*thc -file uses bo casi 

七 he output of Dcsc\rializjcO 
■to a Dcdk. That's because 

written");p C seHali^0 rcWhs ah 

objcd*t> bu*t doesh ’ 七 hcdcssa v-ily 
khow what type object. 


private void button4_Click(object sender, EventArgs e) 
using (Stream input = File.OpenRead("Deck2.dat")) 
BinaryFormatter bf = new BinaryFormatter(); 
for (int i = 1; i <= 5; i++) { 

Deck deckToRead = (Deck)bf.Deserialize(input); 
DealCards (deckToRead, "Deck #" + i + ，’ read"); 


As lohg as you das*t 七 he 
objects you read o^-f 
七 he s*t\rcar»\ -fco *tKc \rigK-t 
type ； you cat\ serialize ov 
deserialize a while buhdh Jc 
objcdts, ohc after ahothev. 


O TAKB A UOOK AT TUB FlUB YOU 

Open up Deckl.dat in Notepad (File . Create () created it in the bin \Debug folder under 
your project folder). It may not be something you’d read on the beach, but it’s got all the 
information to restore your whole deck of cards. 
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builds character 



0 


VOAIT A MINUTB. 工 , M MOT SURE 工 
UIK6 AUU THIS WRITING OBJBCTS OUT JO S^MB WBIRD 
FIUB THAT U>OKS UKB d^ARBA^B WHBN I OPB^ IT UP. VONBN 
工 VJ^OJB THE DB6IC ^)F 6ARDS AS STRIN 多 S , 工 COUi,l> ^PBN 
UP THB OUTPUT IN N^TBPAD AND SBB BVBRVTHIN^ IN IT. 工 SM，T 
6# SUPP^SBD T^> MAICB IT BASY MB T^> UNDBRSTAND 

BVBRVTHIN^ 工 , "V D^IN^? 


When you serialize objects out to a file, they’re written in a binary format. 

But that doesn’t mean it’s indecipherable — just compact. That’s why you can recognize the strings 
when you open up a file with serialized objects in it: that’s the most compact way G# can write 
strings to a file — as strings. But writing out a number as a string would be really wasteful. Any int 
can be stored in four bytes. Storing the number 49,369,144 as an 8-character string that you could 
read takes 8 characters (10 if you include commas), but a binary formatted int only takes 4 bytes. 


Later in the book you’ll learn about a less compact, more human-readable (and editable!) serialization format. 


■NET uses Unicode to encode a char or string into bytes. Luckily, Windows has a useful 
little tool to help us figure out how Unicode works. Open up the Character Map (use the 
Search charm on the Start page to find it, or press Windows-R and type “charmap.exe”). 


Beliind 

the Scenes^ 


When you look at all the letters and symbols that are used in languages all around the world, you realize just how 
many different things need to be written to a file just to store text. That’s why .NET encodes all of its strings and 
characters in a format called Unicode. Encoding just means taking the logical data (like the letter H) and turning it 
into bytes (the number 72). It needs to do that because letters, numbers, enums, and other data all end up in bytes 
on disk or in memory. And that’s why Character Map is useful — it shows you how letters are encoded into numbers. 



Select U| 灼七 

扣 d sCroW doym ur\*bil Y ou 

七 ^ Hcbvcv/ letievs. 

F*md i\\t \tiitr Slim artd 

t\\cV oh it 
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Wcbvcw Icttcv* Shih is humbev 
0 弓£卞 That ； s oi hexadecimal 
hurwbc\r— u hcx w -Pov- shov-t. 

^ i 
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ihe IVihdows ^kula-fcov-* it up, 

put it ih 你 ode, didk "the 

W’ v-adio buWo", Chlcv- 你 Ef? 

ahd thch dick 一 i-(： ； s 
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reading and writing files 


•NET uses Unicode to store characters and text 


The two G# types for storing text and characters — string and char — keep their data in 
memory as Unicode. When that data’s written out as bytes to a file, each of those Unicode 
numbers is written out to the file. So start a new project and drag three buttons onto a form 
and we’ll use the File . WriteAllBytes () and ReadAllBytes () methods to get a 
sense of exactly how Unicode data is written out to a file. 




O K/ie/rg A SmiN 沒 ^>UT TO A FlUB ANt> I2BAO IT BACK. 

Use the same WriteAllText () method that you used in the text editor to have the first 
button write the string “Eureka!” out to a file called eureka.txt. Then create a new byte array 
called eureka Bytes, read the file into it, and then print out all of the bytes read: 




File.WriteAllText("eureka.txt n , "Eureka !")； 

byte[] eurekaBytes = File.ReadAllBytes("eureka.txt M ); 


foreach (byte b in eurekaBytes) 
Console.Write("{0} ", b); 
Console.WriteLine (); 


义 TV RcadAllBytcsO a 

X ^ a av-v-ay <^c by-tes 七 hat all ok 

bytes i\\ai v/cv-c vead m -fvom i\\c -file- 


You’ll see these bytes written to the output: 69 117 114 101 107 97 33. Now open up the 
file in the Simple Text Editor that you wrote earlier in the chapter. It says “Eureka!” 


MAKB THB SBC^>Nt> BUTTON t>ISPUAY TUB BYTBS AS HBX NUMB5RS- 

It’s not just Character Map that shows numbers in hex. Almost anything you read that has to do with 
encoding data will show that data in hex, so it’s useful to know how to work with it. Make the code for the 
second button’s event handler in your program identical to the first one, except change the Console 
Write () line so it looks like this instead: Wcx uses the hurwbc\rs O thv-oujh 

letters "thvoujh F -fco \rcp\rcsch"t humbevs 
•m base I A, so is ho \Ol. 

That tells Write () to print parameter 0 (the first one after the string to print) as a two-character he 
code. So it writes the same seven bytes in hex instead of decimal: 45 75 72 65 6b 61 21 


Console.Write("{0:x2} ", b); 


MAKB THB TH!12t> BUTTON UMIT5 ^>UT L5TT5RS 




Go back to Character Map and double-click on the Shin character (or click the Select button). It’ll add it to 
the “Characters to copy” box. Then do the same for the rest of the letters in “Shalom ”： Lamed (U+05DG), 
Vav (U+05D5), and Final Mem (U+05DD). Now add the code for the third button’s event handler. It’ll 
look exactly like button 2, except for one change. Click the Copy button in Character Map, and then paste 
the letters over “Eureka!” and add the Encoding . Unicode parameter, so it looks like this: 


File . WriteAllText ( "eureka . txt n , M , Encoding.Unicode); 


Did you notice that the IDE pasted the letters in backward? That’s because it knows that Hebrew is 
read right-to-left, so any time it encounters Hebrew Unicode letters, it displays them right-to-left. Put 
your cursor in the middle of the letters — the left and right arrow keys reversed! That makes it a lot easier 
if you need to type in Hebrew. Now run the code, and look closely at the output: f f fe e9 05 dc 05 
d5 05 dd 05. The first two characters are “FF FE’’，which is the Unicode way of saying that we’re 
going to have a string of two-byte characters. The rest of the bytes are the Hebrew letters — but they’re 
reversed, so U+05E9 appears as e9 05. Now open the file up in your simple text editor — it looks right! 
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take a byte out of crime 


C # caw use byte arrays to move data around 


Since all your data ends up encoded as bytes, it makes sense to 
think of a file as one big byte array. And you already know 
how to read and write byte arrays. 



TW»s *»s a U 

av-ra? out ^ 

•f ile 



厂口： r::V 

~ -,S *m order too- 


^ to a W^a 7 , 


七 k avrai 




byte[] greeting; 

greeting = File.ReadAllBytes(filename) 



一 ■ - 
1 by*tc variables 

oiomiam 

O I Z 3 午弓心 
72 101 108 108 111 33 3 ； 





J^ esc ^^bc\rs s\rc 
r he 卜純 

J, 0}r 

u Hc/| 0 // w ,h 


Array.Reverse(greeting); 

File.WriteAllBytes(filename , greeting) 
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Wow Ihc bytes av-c *m 
V"CVC\rsc o\rdc\r. 


Rcvcv-s*m^ *thc by*tcs *m u ttcllo^ w ov\\y y/o\rks bedduse cadh o-f -those 

匕 "tevs is oy\c byte \oy\^- Cdr\ you -fi^uve ou*t v/hy *this y/oir /七 v/ovk 

(or Dl 1 ?^? 













Use a PmaryWritcr to write binary data 


reading and writing files 

also (hdodcs youv 
data. It just specializes ih text 
3hd text Chdodih^. 


You could encode all of your strings, chars, ints, and floats into byte arrays before writing 
them out to files, but that would get pretty tedious. That’s why .NET gives you a very useful 
class called BinaryWri ter that automatically encodes your data and writes it to 
a file. All you need to do is create a FileStream and pass it into the BinaryWr iter’s 
constructor. Then you can call its methods to write out your data. So let’s create a new 
Console Application that uses BinaryWr iter to write binary data to a file. 


o 


o 


❺ 



Start by creating a Console Application and setting up some data to write to a file. 

int intValue = 48769414; l h 0 ^ usc File CveateO, it'" siavi a hew ^ile—i-f 

string stringValue = "Hello ! "; xJhcirc s ov\t theve allready, it’ll blow it away 

byte [] byteArray = { 47, 129, 0 , 116 }; stairt a b\rahd-hcw oy\t. Thcv-cs also the nl< 


float floatValue 
char charValue = 


491.695F, 


E 


0 ? ^\ic0 method, o P e,s -the 
air>d 也士 it the be 9 ihhih9. 


OhC 


To use a BinaryWr iter, first you need to open a new stream with File . Create () : 

using (FileStream output = File.Create("binarydata.dat")) 
using (BinaryWriter writer = new BinaryWriter(output)) { 

Now just call its Write () method. Each time you do, it adds new bytes onto the end of the 
file that contain an encoded version of whatever data you passed it as a parameter. 


writer.Write(intValue); 
writer.Write(stringValue) 
writer.Write(byteArray); 
writer.Write(floatValue); 
writer.Write(charValue); 



Eadh lV\ri*tcO 伙七 erodes OY\C 

value m*to by*tcs, a^d scr>ds -those 

by*tcs -to the FilcS*t\rcam objedt Y ou The pilcS-tv-cam 

tav\ pass i*t a^y value type, a^d i*tll wv-i-tes -the bytes -to 

tr\todt i*t auWa*tidally. the tv\d o( 七 he -Pile- 




O Now use the same code you used before to read in the file you just wrote. 

byte [ ] dataWritten = File . ReadAllBytes ( "binarydata . dat" ) ; (^y^ s 3 y 5 ta b 

foreach (byte b in dataWritten) so ihc has "to stavt 

Console . Write ( " { 0 : x2 } n , b) ; v/.rth 3 1 

Console.WriteLine(" - {0} bytes ", dataWritten.Length); 

Console . ReadKey () ; Chdv-ad'tcv* Alap. 


i^urwbcv- -fco icfl NET how 
I 。》|七 is. Also, you cav\ look up 七 he 
s-tv-'mj dhav lAWitodc values us'm^ 


Write down the output in the blanks below. Gan you figure out what bytes 
correspond to each of the five Write () statements? Mark each group of bytes with 
the name of the variable. 


bytes 
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an amalgam of data 


-float Br\d mi values *take uf 午 bytes you 
~ w\r'rtc them *to d -file- |-f you’d usedloM oV" 
yf double, -they d take uf Q bytes ca^h- 


- > 


V 


c^terpen your pencil 


04 V\ c« OX Ob 45 kt U Zl 91 00 (b d« ^ M ^ - XO 


bytes 


_ ——一 
*m*t\/aluc 


s*brm^/alu 


t 


by 七 e/Way f loai\/alue AavValue 


The -first byte \y\ the is 石一 *tha*t’s 

the o-f *thc s-tv-mj. Y® u usc 

Chav-a^tev Map *to look uf <^f the 
^hav-a^tev-s \y\ w ttcllo| w —i*t starts with 
U+OO^"0 a^d tY\ds y/rth U+OOZI. 



|-f you use *t^c IA/mdoy/s 
daldula-tov *to dor\vcvt *t^csc 
by*tcs -fvom lie% *to dc 匕 you 

cav\ see i\\ai tiicsc art 
r\umbcvs m byte/Wray. 


匕 hav holds d U^idode 

^hav-a^tc\r, av\d ^ ohly 
■t^kes ohc byte 一 _*t’s 
ty\Codtd as W+OO 午弓 . 


Use PiwaryReaderto read the data back in 

The BinaryReader class works just like BinaryWriter. You create a 
stream, attach the BinaryReader object to it, and then call its methods. 
But the reader doesn’t know what data’s in the file! And it has no way 
of knowing. Your float value of 4 91.695F was encoded as d8 f 5 43 45. But 
those same bytes are a perfectly valid int — 1,140,185,334. So you’ll need 
to tell the BinaryReader exactly what types to read from the file. Add the 
following code to your program, and have it read the data you just wrote. 


1)oy\ "t "tolkc OUV* Y/OV*d *Po\r it 
Replace -the l*mc tha-t v-cads -the 
-float wi-th a dal I -to Rcadlh-t^ZO 
need "to -the type 
o( -floatRcad -to mi.) Thc^ you 
^ SCC -Po\r you\rsd-P v/hai it 
breads -from -the -Pile. 


Start out by setting up the FileStream and BinaryReader objects: 

using (FileStream input = File.OpenRead("binarydata.dat M )) 
using (BinaryReader reader = new BinaryReader(input)) { 

o You tell BinaryReader what type of data to read by calling its different methods. 


int intRead = reader.Readlnt32(); 
string stringRead = reader.Readstring(); 
byte[] byteArrayRead = reader.ReadBytes(4) 
float floatRead = reader.Readsingle(); 
char charRead = reader.ReadChar(); 



value type has its wthocU 
V>^KtadM) i^ai ^ daia 

,h 匕針杜七 type. /V\osi do^i hcc d 

ah Y but ReadByicsO takes 

pairam 士 ir 七 ha 七七 c || s BmavyRcadcv 
how m3r\y bytes -to v-cad. 


❺ 

l-f youVc addm^ 
•this Code *to 

七 he cv>d of 七 k 

fVO^vam OY\ 
pvcvious pa^C) 

do^*t -fovyt 七 k 
o*thcv* Rcadi^cyO 
七 ha 七 >wa*rb -fov a 
kcys*tvokc. 


You tell BinaryReader what type of data to read by calling its different methods. 

Console.Write("int : {0} string : {1} bytes : ", intRead, stringRead); 

foreach (byte b in byteArrayRead) 

Console.Write("{0} ", b); 

Console.Write(" float : {0} char : {1} ", floatRead, charRead); 

} 

Console.ReadKey(); 

Here’s the output that gets printed to the console: 

int : 48769414 string : Hello! bytes : 4 7 12 9 0 116 float : 4 91.695 char : E 
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reading and writing files 


You can read and write serialized files manually, too 

Serialized files don’t look so pretty when you open them up in Notepad. You’ll find all 
the files you write in your project’s bin \Debug folder — let’s take a minute and get more 
acquainted with the inner workings of a serialized file. 

o Serialize two Card objects to different files. 

Use the serialization code you’ve already written to serialize the Three of Clubs to three-c. dat and Six 
of Hearts to six-h.dat. Check to make sure that both files were written out and are now in a folder, 
and that they both have the same file size. Then open one of them in Notepad: 



TV^cv-c avc 

sowc v/ovds ^ 

如 ku-t 
•1 七 ’s mostly 

uvxv-cadaWc. 





three-c.dat - Notepad 


n 


File Edit Format View Help 


yyyy 宇 ] ESerializeCards j Version=l .0 .0.0 j Cuityre=niGutral J 

PubIicKeyToken=null | !!SerializeCards.Card-| 

- L <Suit>k — BackingFieldT<Value>k — BackingField J J *]|SerializeCards. Suits-] 
-'-SerializeCards .Values-] -| | yyyyllSerializeCards. Suits •value_ Q-| 

I uyyy- L SerializeCardls .Values •value 一 Q-| L I 


A, 


v 


Do: 七 
-Po\rjci 七 he 
"two 



Write a loop to compare the two binary files. 

We used the ReadByte () method to read the next byte from a stream — it returns an int that contains 
the value of that byte. We also used the stream’s Length field to make sure we read the whole file. 


byte[] firstFile = File.ReadAllBytes("three-c.dat"); 
byte[] secondFile = File.ReadAllBytes("six-h.dat"); 
for (int i = 0; i < firstFile.Length; i++) 
if (firstFile[i] != secondFile[i]) 



Console.WriteLine("Byte #{0}: {1} versus {2} n , 

i r firstFile [i], secondFile[i]); 



This loop ocam'mes the byte -fvom cadh 

-files 3hd "tliCh "the sedohd by*tc ； 

W\\tv\ i"t -fihds 3 i"t 


TKc tv/o -files avc ytdid 七 v/o 

byte a\rrays, so dan 
be domp3vcd by*tc by byte. 

Sd^e dass Y/ds scvial'iz^d *to 七如。 
-files, be alr^os*t 

ider^aL.bu*t Id see jus*t HOW 

identical avc. 


writes a lihe -to the dohsole. 



Watch it! 


weVe been 


When you write to a file, you don’t 
always start from a clean slate! 

Be careful if you use File.OpenWrite(). It 
doesn’t delete the file 一 it just starts overwriting 
the data starting at the beginning. That’s why 
using File.CreateQ_it creates a new file. 


► We ? re not done Vet-Clip the pa^e! 
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celebrate our differences 


Fmd where the files differ, and use 
that information to alter them 


The loop you just wrote pinpoints exactly where the two serialized 
Card files differ. Since the only difference between the two objects 
were their Suit and Value fields, then that should be the only 
difference in their files, too. So if we find the bytes that hold the suit 
and value, we should be able to change them to make a new card 
with whatever suit and value we want! 


❺ Take a look at the console output to see how the two files differ. 

The console should show that two bytes differ: 

Byte 1 versus 3 

Byte #364 : 3 versus 6 

That should make a lot of sense! Go back to the Suits enum from the last chapter, and you’ll find 
the value for Clubs is 1 and the value for Hearts is 3, so that’s the first difference. And the second 
difference — six versus three — is pretty obviously the card’s value. You might see different byte 
numbers, which isn’t surprising: you might be using a different namespace, which would change the 
length of the file. 


Remember how ihc hamespade was ihdud 山 s p 扣七 
七卜 scHali^d Uc? ^ you^ 一叩々 is lo, 
Sheris, thch the byte hur^brn will be 




tY o\r 


byte scv'ial'i^d -f ile 

vcpv"csc^*ts suit should be able *to 

su'i-t o( card by ^ilc 

•m, byte, ar\d I*t out 

(Rcmcmbcv-, youv ovm scvializ^d 眯吵七 

short *tKc suit at a diWcvc^*t loda-tio^.) 


o 



ky*tc humbc\rs 

•m step 料， 
subs*ti*tu*tc 
七 hem ih hc\rc. 


Write code to manually create a new file that contains the King of Spades. 

We’ll take one of the arrays that we read, alter it to contain a new card, and write it back out. 

firstFil^T307l\ —— (byte) Suits . Spades; _ 

f irstFile ^364 / = (byte) Values . King; ) """"" 

File . Delete ( "king-s . dat" ) ; 

File . WriteAllBytes ( "king-s . dat" firstFile) ; 

Now deserialize the card from king-s.dat and see if it’s the King of Spades! \ 

Noyj 七 you khow whidh by*tcs 
doh*tdih the suit 3hd value, you 
Uh jus*t those bytes 

m array bc-fovc i-t jc-ts 
writteh out *to kihg - s.dat. 
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Working with binary files can be tricky 


What do you do if you have a file and you aren’t quite sure what’s inside it? You don’t 
know what application created it, and you need to know something about it — but when 
you open it in Notepad, it looks like a bunch of garbage. What if you’ve exhausted 
all your other options, and really need to just look inside? Looking at that picture, it’s 
pretty clear that Notepad just isn’t the right tool. 

s the sc\rialiicd opened uf ih 
Notepad. That s hot gomg -fco be usc-Pul at all. 



kihg-s.dat - Notepad 


File Edit Format View Help 


yyyy ¥-| ESerializeCards, Version=l. 0.0.0! Culture=neytralj 

PublicKeyToken=null | jjSerlalizeCards .'Card-] 

- L <Suit>k — BackingFieldT<Vaiue>k — BackingField J J llSerializeCardls. Suits-| 
^SerializeCardls .Values-| i | yyyyilSeriaiizeCardls. Suits •value — Q-| 

I 啡砰丄 SerializeCards ■ Values -value — Q-| ^ 



Kcl^ul. else do you rn y 敵 a 七 ed. 


There’s another option — it’s a format called a hex dump, and it’s a pretty standard way to look at binary 
data. It’s definitely more informative than looking at the file in Notepad. Hexadecimal — or “hex” 


is a 


convenient way to display bytes in a file. Every byte takes 2 characters to display in hex, so you can see 
a lot of data in a really small space, and in a format that makes it easy to spot patterns. Also, it’s useful 
to display binary data in rows that are 8, 16, or 32 bytes long because most binary data tends to break 
down in chunks of 4, 8, 16, or 32" .like all the types in G#. For example, an int takes up 4 bytes, and 
is 4 bytes long when serialized on disk. Here’s what that same file looks like as a hex dump, using one of 
any number of free hex dump programs available for Windows: 


You immediate 1 丫 

sec v\umCVid 

value o-f catii byte 
\y\ *tKc -file- 


The ^urwbcv- at the 

o( eddh 
I me is the o<f*Pse 七 
(o\r ih-fco the 

-file) o( 七 he -Piv-s-t 

byte m the Ime. 



Yo[a still 

get to see 
the oiri^mal 
text, but 
the gavbage 

3v-c v-cpla^cd 

with dots. 


07 

08 


051db03 06 09035115160 
06334073166070660670 




0 ad5304449 C040360370 
_w Tf To _b -b _u _b T_1 _t -b _b _u _-b _u 4* Tf _u 4* _u _M_ 

09 029129 Cbl220570500 

_M_ _b _b T_1 _t _M- T-i -b _b -b _-b _M- Tf _M_ _b -M- _M_ _b _M_ 

0 cf5 C515539310 a00 a0d 

_M_ rb lbTf _t _M_ _b Tf _b -b _-b Tf _b -M- Tf _M- -M- Tf _M- _M_ 

01942 C33912432900900 

_M_ _b _b Tf _b -b ^^5 _b -b Tf Tf 4* _M_ _-b _M- _M_ _b _M- _M_ 
093 C5 C5 CG25950 C00 CIS 

-M- rb Tf rb rb 00 4^ 4^ rb rb rb _M_ -h- _M- _M- -h- _M- _M_ 

122505 a57f35 a0110130 
07775771655770600670 

d5530 e90 ef4390930952 
f6642G606515GOG706GO 


d360 cd C09b4 e C2242258 
f55223G0G60260770770 

dso c c elob 643135985 Co 
f422G6G0G307676G0G60 

d0 C0159235449535031f 
f023G6G0G6666G57o565 

003 e2b2415 C22543f56f 
00727676676777155155 

00404f522 C515 cd efd e5 
o0G376G746666Gf25f2G 

022 e5431f19331d35d35 
O0727566566456f76f77 


1 C105o^^ 
0 0 6 3 6 


f66556d45d4 c 
554G15f67fG6 


eb C7 a0 ed2 Cd21b 
2G36702f7Gf7G0 


_M -M- -M- _M_ _M- _M- _M_ 

cd ef01234 
0OOO11111 
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69 73 6e 27 74 20 74 68 69 73 20 66 75 6e 3f0a 


Use file streams to build a hex dumper 

A hex dump is a hexadecimal view of the contents of a file, and it’s 
a really common way for programmers to take a deep look at a file’s 
internal structure. Most operating systems ship with a built-in hex 
dump utility. Unfortunately, Windows doesn’t. So let’s build one! 


How to make a hex dump 

Start with some familiar text: 


We the People of the United States, in Order to form a more perfect Union.•• 


Here’s what a hex dump of that text would look like: 

you iw'wvcdb 七 cly sec 

value cadK byte *tKc -file" 


0000 : 

57 

65 

20 

74 

68 

65( 

20 ^ 

>50 -- 

65 

6 f 

70 

6 c 

65 

20 

6 f 

66 

We the People of 

0010 : 

20 

74 

68 

65 

20 

55 

6 e 

6 9 — 

74 

65 

64 

20 

53 

74 

61 

74 

the United Stat 

0020 : 

65 

73 

2 c 

20 

69 

6 e 

20 

4f -- 

72 

64 

65 

72 

20 

74 

6 f 

20 

es r in Order to 

0030: 

66 

6 f 

72 

6 d 

20 

61 

20 

6 d—— 

6 f 

72 

65 

20 

70 

65 

72 

66 

form a more perf 


65 

63 

74 

20 

55 

6 e 

69 

6 f -- 

6 e 

2 e 

2 e 

2 e 





ect Union... 


l/Ve II add the hurwbev- a-t the o-P eddh I'me by us'ma 

the o-P-fsct o( the -Piirs-t byte m the Ime. 


Each of those numbers — 57, 65, 6F — is the value of one byte in the file. The reason some of the “numbers” 
have letter values is that they’re hexadecimal (or hex). That’s just another way of writing a number. Instead of 
using 10 digits from 0 to 9, it uses 16 digits from 0 to 9 plus the letters A through F. 


Ahd well 
y\ttA -to 

opiate the 
gav-bage 

with pev-iods. 


Each line in our hex dump represents 16 characters in the input that was used to generate it. In our dump, 
the first four characters are the offset in the file — the first line starts at character 0, the next at character 16 
(or hex 10), then character 32 (hex 20), etc. (Other hex dumps look slightly different, but this one will do for 
us.) 


Working with hex 

You can put hex numbers directly into your program — just add the 
characters Ox (a zero followed by an x) in front of the number: 

int j = 0x20; 

MessageBox. Show ("The value is ’▼ + j); 

When you use the + operator to concatenate a number into a 
string, it gets converted to decimal. You can use the static String 
Format () method to convert your number to a hex-formatted 
string instead: \ 

string h = String • Format (’▼{ 0 : x2 }" , j); 
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5V"rw3*tO uses 

jus 七 ,like CohsoIc.lVv-i-tcLihcO, so you 
{jo use it 







reading and writing files 


StreamReader and StrcarnWritcr will do just f iwc (for wow) 

Our hex dumper will write its dump out to a file, and since it’s just writing text a *tKc 

StreamWriter will do just fine. But we can also take advantage of the ReadBlock ()Lr ^dalled RcadBlodkO is 
method in StreamReader. It reads a block of characers into a char array~you 
specify the number of characters you want to read, and it’ll either read that many 
characters or, if there are fewer than that many left in the file, it’ll read the rest of the file. 

Since we’re displaying 16 characters per line, we’ll read blocks of 16 characters. 


So add one more button to your program — add this hex dumper to it. Change the first 
two lines so that they point to real files on your hard drive. Start with a serialized Card 
file. Then see if you can modify it to use the Open and Save As dialog boxes. 


-tKa-t you td\\ i*t> 
w blo£.ks ；， (v/hidii 
keeps a 灼 d docs^ *t 

VC*tuVr\ *to youv 
uvrt’il rt’s vead all 

dV>avad*tcv-s you asked (or or 
\ruir\ ou 七 。•^ di3*bci *to V"C3d- 


using (StreamReader reader 
using (StreamWriter writer 


int position 


=new StreamReader(@ n c:\files\inputFile.txt")) 

=new StreamWriter(@ n c:\files\outputFile.txt ", false)) 

A S-t^amRcadcrs (a\st 

0; 、广 -theve avc diiav-at*tcvs still Irf 七 *to vead i\\t 

while (!reader.EndOfStream) { This RcadBlo^kO ca\\ v-cads up -to I 

char [ ] buffer = new char r 161 七 a Aav" avray. ^ 

int charactersRead = reader. ReadBlock (buffer , 0, 16); / 飞匕 S-t\rihg.Fov-mat 

method dohveirts humbevs 

String. Format ( n {0 :x4} ’▼, position) ) ; ^ s . 私乂午}"純 


writer.Write (’ ▼ {0}: 


position += charactersRead; 


TK'is loop ^ocs 
■tWou^K 
tKavadtcv-s 
dr^d fv-'mts 
cadii o*r 
•fco d Imc m 
七 he ou*tfu*t- 


for (int i = 0; i < 16; i++) { 

if (i < charactersRead) { 

string hex = String. Format ( f, { 0 : x2 } 


fs- Fo^aiO -to pv-ih-t -tk 

m -this 

乙 as 。 posi 七 ioh — 3 *(*ouV"— 
hex hur^bev". 


(byte)buffer[i]) 


writer.Write(hex + 


else 


writer.Write(" 


c , 心 a 6Ws 4 a value 亡 

- -； 11 ^ a11 
oJf 七一 4 a —. 

-’▼);} 


if (i == 7) { writer.Write( f 

if (buffer [i] < 32 | | buffer [i] > 250) { buffer [i] 


匕 airvay -to a 

户 by passing \i 

to overloaded 
^Ohs-tvu^-tov -fov 

s*t\rihj. 


string bufferContents 
writer.WriteLine ( n 


=new string(buffer); 

〖▼ + buf ferContents . Substring (0 , charactersRead)); 

E 败 v sirM V^as a Subst— method a ^ f ^ 

••七代 W 七 k 仏七 ^aratWsRcad ，七 ” 

:：b - 

o*f dV^av-a^*tcv-s >*t v-cad m*to *tV^c av-v-ay ) 
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build hexdump right 


Use Strcam-RcadO to read bytes from a stream # Z 0 ~ Dq ^ 1S 

. . ^ 

The hex dumper works just fine for text files. But there’s a problem. Try using File . WriteAllBytes () to write 

an array of bytes with values over 127 to a file and then run it through your dumper. Uh oh — they’re all read in as 

“fd ”！ That’s because StreamReader is built to read text files, which only contain bytes with values under 128. 

So let’s do this right~by reading the bytes directly from the stream using the Stream. Read () method. And as a 

bonus, we’ll build it just like a real hex dump utility: we’ll make it take a filename as a command-line argument. 

Create a new Console Application and call it HexDumper. The code for the program is on the facing page. 

Here’s what it will look like when you run the program: 


l-f you r\AY\ wi 七 hou*t a^y 

i*t v-c*tu\r^s By\ CV-V-oV message 
C^i*U v/rth a 灼 CV-\ro\r todc- 


H also ocits y/ith c\r\ro\r i-f you pass i-t 
the r\3mc o( a -file that doesh t exist 




C:\Window 辦 ystem32\cmd.exe 


n 



■C : \Us©rs\Public\Pro jeqJJsXHexDu 
usage : HexDumper file-to-dump 




HexDumper.exe 


IC : \Users\Public\Proj©cts\HexDumper>H©xDump©r.exe does-not-exist.dat 
File does not exist : does-not-exist.dat 


[_ 


: \Us©rs\Public\Proj©cts\HexDumper>HexDump©r 


0000 

0010 

0020 

0030 

0040 

0050 

0060 

0070 

0080 

0090 

OOaO 

OObO 

00C0 

OOdO 

OOeO 

00fO 

0100 

0110 

0120 

0130 

140 


00 01 
00 0c 
43 61 
2e 30 
6e 65 
65 79 
00 13 
2© 43 
6b 5f 
3c 56 
67 46 
7a 65 
00 15 
2e 56 
fd ff 
72 64 
6c 75 
fc ff 
72 64 


00 00 
02 00 
72 64 
2e 30 
75 74 
54 6f 
53 65 


ff ff 
73 2© 
65 5f 
ff ff 
73 2e 


00 ff 
00 00 
73 2c 
2e 30 
72 61 
6b 65 
72 69 
6 ^ 02 
61 63 
75 65 
6c 6H 
72 64 
72 69 
75 65 

14 53 
53 75 
5f 00 

15 53 
56 61 


ff ff 
45 53 
20 56 
2c 20 
6c 2c 
6e 3d 
61 6c 
00 00 
6b 69 
3e 6b 
04 04 
73 2e 
61 6c 
73 02 
65 72 
69 74 
08 02 
65 72 
6c 75 


ff 01 
65 72 
65 72 
43 75 
20 50 
6g 75 
69 7a 
00 15 
Se 67 
5f 5f 
14 53 
53 75 
69 7a 
00 00 
69 61 
73 01 
00 00 
69 61 
65 73 


00 00 
69 61 
73 89 
6c 74 
75 62 
8c 6c 
65 43 
3c 53 
H6 69 
42 61 
65 72 
69 74 
65 43 
00 02 
0c 69 
00 00 
00 01 
0c 69 
01 00 


exe thre©-c 
00 00 00 00 
6c 69 Ta 65 
6f 6e 3d 31 
75 72 65 3d 
6c 69 63 4b 
05 01 00 00 
61 72 64 73 
75 G9 74 3© 
65 6c 6M 16 
63 6b 69 6e 
69 61 6c 69 
73 02 00 00 
61 72 64 73 
00 00 00 05 
7a 65 43 61 
00 07 76 61 
00 00 00 05 
7a 65 43 G1 
00 00 07 76 


dat 


.ESerialize 

Cards, U©rsion=1 
.0.0.0 ， Culture: 
neutral, PublicK 
©yTok©n=null …. 

•.SerializeCards 

.Card.<Suit> 

k__BackingField. 
<Ualu©>k__Backin 
gField...Seriali 
zeCards.Suits … 

..SerializeCards 

.Ualues. 

.SerializeCa 

rds. Suits.ua 

lue ― . 

.SerializeCa 

rds. Ualues.u 


lue 


.I-f you pass i-t a 
valid -filename, i-tll 
wvitc a hey. dump 
the 

o( the -Pile -fco tlic 
do^solc. ^ 

Novrwally y/c use Console. 
l/V\ri-tcLmcO -fco 

to 七 he dor^solc- But 
wc II use Coir>solc.Ev-v-ov. 
lAArrteLmeO ^to pr’nvt 
cv-v-ov messages so -they 
doh’ 七 get iredilredied 
i-f v/C use > o\r » -to 


_ 


: \Us©r 
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"Bic outpui. 

^ S,h 9 - lihe ar^urhCh-ts 

-ethld ^ £ la« ^ eni ^ 

广 is, 1 — ? a^ e ^ wi || Coniain ih 2 J , 敁 一 ‘ 

You II w^-t io pass Co^d-Uc "ts VouW 如 “ A . 

一，，一 e j „ l ^ 
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reading and writing files 


Cornma^d-lmc y/ill be 

f>dsscd usm^ *bV^c 3v*^s pavdmc'tcv'. 



static void Main(string[] args) 


l-P a\rjs.LchJ-th is r>o-t 
c^ual bo I, ci-thcv- 
z^v-o or mo\rc ihar> ov\t 
av-^umc^i was passed on 

the 乙 onrtmdnd Ime. 


if (args.Length 


1) 


Koti^c hoy/ v/cVc usm^ Console- 

tv-v-ov lVv-i*tcLmc() hcv"C. 

Console.Error.WriteLine("usage : HexDumper file-to-dump 
System.Environment.Exit(1); 


This <\uits tVic 

if you ^3ss i*t 3^ •… 七， 

it will rcWn t^at trror CoAt 
C^\cM is usc-ful youVc 

乙 omma 灼 d s^\rip*b a^d f iles). 


if (!File.Exists(args[0]) 




args[0]); 


Console.Error.WriteLine("File does not exist : {0}' 

System.Environment.Exit(2); 

l/Vc Aoy!{, y\ccA B 


Let’s make suve *tha*t a 
valid -f ile v/as passed- l-f 
•rt does / 七 c^is-t, fvm 七 a 

d*l-f-fcv-cir>*t CV-VOV message 
av\d v-c*tuvv> a d*i-f-fcv-cir>i 

e%i 七 Code 


using (Stream input = File.OpenRead(args[0])) 

{ 

int position = 0; 

byte[] buffer = new byte[16]; 

while (position < input.Length) 

{ 

int charactersRead = input.Read(buffer, 
if (charactersRead > 0) 


TVis part 
七 IlC s3w»C> 

七 he bu-f-fcv toy\*bams 
bytes d^d ir\o*t 
dava^tevs (but 
S'brmJ.Porma 七 (） 
does the \ri # 七 
七 iVn^ m ci*b^cv ^3sc)- 


Si\rcarwRcadc\r because 
wcVc v-eadmg by-tes 

div*C^tly -f\rorw "the s-tv*c3rn. S*t\rc3nr».Rc3clO method 

Jx> vead bytes divcdily mto 
a bu-Pfcv. hlob^c hoy/ 七 his 
time the bu-f-fcv- is a byte 

avray. That makes sc^sc—v/cVc 

'rcadihj bytes , ⑽七 dhavadtevs 
-f\ronr» d tc^t -Pile- 



0, buffer.Length); 


Console.Write("{0} : ", String.Format("{0:x4} 
position += charactersRead; 

for (int i = 0; i < 16; i++) 

{ 

if (i < charactersRead) 

{ 

string hex = String • Format ("{ 0 : x2 }▼，， 
Console.Write(hex + ""); 


position)); 


(byte)buffer[i]); 


else 


Console.Write(" 


)； 


if (i == 7) 

Console.Write("); 


if (buffer[i] < 32 || buffer[i] > 250) { buffer[i] 


(byte)'.'; } 


string bufferContents = Encoding.UTF8.GetString(buffer); 
Console.WriteLine(" 'V^ 1 bufferContents); 



TV^is is ar\ easy >way bo 乙 orwev 七 a byte a^rv-ay -to a 
sVm^. |Vs pav-t E^odm 5 .UTF« (or 

Unicode ov ASCII, OV tUod\^) 

because di-f-fcvc^-b c^^odmy CBv\ map sarwc byte 
av-v-ay *to di-f-fc\rcr\*b s*brmy. 


If you use Start Without Debugging 
(Ctrl-F5) from the Debug menu to 
run a Console App, you’ll get a 
convenient pause and a M Press any 
key to continue …” prompt after 
the program exits._ 


you are here ► 
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no dumb questions 


Why didn’t I have to use the 
Close () method to close the file after 
I used File. ReadAllText ( ) and 
File.WriteAllText() ? 

A! The File class has several very 
useful static methods that automatically 
open up a file, read or write data, and 
then close it automatically. In addition 
to the ReadAllText () and 
WriteAllText () methods, 
there are ReadAllBytes () and 
WriteAllBytes (), which work with 
byte arrays, and ReadAllLines () 
and WriteAllLines () , which read 
and write string arrays, where each string in 
the array is a separate line in the file. All of 
these methods automatically open and close 
the streams, so you can do your whole file 
operation in a single statement. 

If the FileStream has methods 
for reading and writing, why do I ever 
need to use S treamReader and 
StreamWriter? 

The FileStream class is really 
useful for reading and writing bytes to binary 
files. Its methods for reading and writing 
operate with bytes and byte arrays. But a lot 
of programs work exclusively with text files- 
like the first version of the Excuse Generator, 
which only wrote strings out to files. That’s 
where the StreamReader and 
StreamWriter come in really handy. 
They have methods that are built specifically 
for reading and writing lines of text. Without 
them, if you wanted to read a line of text in 
from a file, you’d have to first read a byte 
array and then write a loop to search through 
that array for a linebreak—so it’s easy to see 
how they make your life easier. 
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Dumb Quest! 


ons 


When should I use File, and 
when should I use Filelnfo? 

A! The main difference between the 
File and Filelnfo classes is that the 
methods in File are static, so you don’t 
need to create an instance of them. On the 
other hand, Filelnfo requires that you 
instantiate it with a filename. In some cases, 
that would be more cumbersome, like if you 
only need to perform a single file operation 
(like just deleting or moving one file). On 
the other hand, if you need to do many file 
operations to the same file, then it’s more 
efficient to use Filelnfo, because 
you only need to pass it the filename once. 
You should decide which one to use based 
on the particular situation you encounter. 

In other words, if you're doing one file 
operation, use File. If you're doing a lot of 
file operations in a row, use Filelnfo. 


Things get a little more complicated 
when you add higher-numbered Unicode 
characters into the mix. One byte can only 
hold a number between 0 and 255. But two 
bytes in a row can store numbers between 0 
and 65,536—which, in hex, is FFFF. The file 
needs to be able to tell whatever program 
opens it up that it’s going to contain these 
higher-numbered characters. So it puts 
a special reserved byte sequence at the 
beginning of the file: FF FE. That’s called the 
byte order mark. As soon as a program sees 
that, it knows that all of the characters are 
encoded with two bytes each. (So an E is 
encoded as 00 45—with leading zeroes.) 


Why is it called a byte order mark? 


A! Remember how your bytes were 
reversed? Shin’s Unicode value of U+05E9 
was written to the file as E9 05. That’s 
called little endian.” Go back to the code 


^ that wrote out those bytes and change the 

Back up a minute. Why was third parameter to WriteAllText (): 


“Eureka!” written out with one byte per 
character, but when I wrote out the 
Hebrew letters they took up two bytes? 
And what was that “FF FE” thing at the 
beginning of the bytes? 

A! What you’re seeing is the difference 
between two closely related Unicode 
encodings. Plain English letters, numbers, 
normal punctuation marks, and some 
standard characters (like curly brackets, 
ampersands, and other things you see on 
your keyboard) all have very low Unicode 
numbers—between 0 and 127. (If you’ve 
used ASCII before, they’re the same as the 
ASCII characters.) If a file only contains 
those Unicode characters with low numbers, 
it just prints out their bytes. 


Encoding.BigEndianUnicode. 

That tells it to write the data out in “big endian,” 
which doesn’t flip the bytes around.You’ll see 
the bytes come out as “05 E9” this time. You’ll 
also see a different byte order mark: FE FF. 
And your simple text editor is smart enough to 
read both of them! 


H you’re writing a string 
tkat only lias Unicocte 
ckaracters witk low numbers, 
it writes one tyte per 
ckaracter. But il iVs got 
kigk-nunitereci ckaracters, 
t\iey[[ te written using two 
or more bytes eack. 


Tk is called WTF - 虼 ― U^Tby dc-fault ^ 

tell use a d 淑⑽ t by passmj 

i 七 a tucd\^ value. Vou Ica^ more about 

cModmy a 七 K-t-tf：//uhitodc ovj. 


reading and writing files 



Change Brian’s Excuse Manager so it uses binary files with serialized Excuse objects 
instead of text files. 


© 

❿ 

© 

O 


Make the Excuse class serializable. 

Mark the Excuse class with the [ Serializable] attribute to make it 
serializable. Also, you’ll need to add the using line: 

using System.Runtime.Serialization.Formatters.Binary; 


Wiht: IVhat kcywov-d 


Change the Excuse. Save () method to serialize the excuse. 

When the Save () method writes a file out to the folder, instead of using — ^ y ou usc , hS ,J c ^ 

StreamWriter to write the file out, have it open a file and serialize itself out. ^ k ■{ 3 七 ^ 

You’ll need to figure out how the current class can deserialize itself. -fco itscl-f? 


Change the Excuse. OpenFileO method to deserialize an excuse. 

You’ll need to create a temporary Excuse object to deserialize from the file, and 
then copy its fields into the current class. 

Now just change the form so it uses a new file extension. 

There’s just one very small change you need to make to the form. Since we’re 
no longer working with text files, we shouldn’t use the . txt extension anymore. 
Change the dialog boxes, default filenames, and directory search code so that 
they work with * . excuse files instead. 




THAT TOOK JUST A FBW SMAUU 6HAM^BS 
TO THB AUU THB SAVING AND ^PBMIM^ 

BX6USBS WAS INSIDE THB 6X6USB 6UASS. I JUST HAD 
CHANTS THB 6UASS - 工 BARBUY HAD TO TNB AT AUU. 

r^S UKB THB D^BSN^ BVBN 6ARB ViOVJ THB 6UASS SAVBS 

ITS DATA. IT JUST PASSES IN TNB FIUBNAMB AND ICM^WS 

BVBRrrHIM^ WIUU 公 ET SAVBD PR^PBRUY- 



That’s right! Your code was very easy to change 
because the class was well encapsulated. 

When you’ve got a class that hides its internal operations from 
the rest of the program and only exposes the behavior that needs 
to be exposed, it’s called a well-encapsulated class. In the 
Excuse Manager program, the form doesn’t have any information 
about how excuses are saved to files. It just passes a filename into 
the excuse class, and the class takes care of the rest. That makes 
it very easy to make big changes to how your class works with 
files. The better you encapsulate your classes, the easier they are 
to alter later on. 


Rcmcmbcv- how 
Chdapsulatioh was 
OhC o-P the -Pou\r 
乙 。代 OOP pv-ihdiplcs? 
s ah example 
how usih0 those 
p\rihdiplcs makes youv- 
pv-ogv-a^s bettev-. 


you are here ► 
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SoLjitiOH 


Change Brian’s Excuse Manager so it uses binary files with serialized 

Excuse objects instead of text files_ 

You only need to change these three statements in the 
form: two in the Save button’s Click event, and one in 
the Open button’s — they just change the dialogs to use 
the .excuse extension, and set the default save filename. 


private void save_Click(object sender, EventArgs e) { 

// existing code 

saveFileDialogl.Filter = "Excuse files (*.excuse)|*.excuse|All 
saveFileDialogl.FileName = description.Text + n .excuse M ; 

// existing code 


private void open_Click(obj ect sender, EventArgs e) { 

// existing code 

openFileDialogl.Filter = 

"Excuse files (*.excuse)|*.excuse|All files (*.*)|* 



*，▼; 


files (*.*) I *.* 

bo%cs d ° 

如 br\tY 


// existing code 


[Serializable] ^ N Hevc s ihc E^dusc dass. 

class Excuse { 

public string Description { get; set; } 
public string Results { get; set; } 
public DateTime LastUsed { get; set; } 



The 0h |y io the 

is b> have it dhahgc ihc -file 
extehsioh it passes io -the 
B^duse ^hss. 


public string ExcusePath { get; set; } 


public Excuse() { 

ExcusePath =""; 

} 

public Excuse(string excusePath) 
OpenFile(excusePath); 


You’ll need using System.10; 
and using System.Runtime. 
Serialization.Formatters. 
Binary; in the Excuse class. 


public Excuse(Random random, string folder) { 

string[] fileNames = Directory•GetFiles(folder, n *.excuse"); 
OpenFile(fileNames[random.Next(fileNames.Length)]); 


private void OpenFile(string excusePath) { 
this.ExcusePath = excusePath; 

BinaryFormatter formatter = new BinaryFormatter(); 
Excuse tempExcuse; 

using (Stream input = File.OpenRead(excusePath)) { 

tempExcuse = (Excuse)formatter.Deserialize(input) 


The dor\s*t\ru^*tov -fov- load'mj 
rav\don\ causes v\ccds *to look 
(or t%iw\ov\ 

'mstcad o-f 认氺七乂七”仑 


Description = tempExcuse.Description; 
Results = tempExcuse.Results; 

LastUsed = tempExcuse.LastUsed; 


public void Save(string fileName) { 

BinaryFormatter formatter = new BinaryFormatter(); 
using (Stream output = File. Open^vte(fileName)) { 

formatter. Serialize (output , thisO; pass m “this” 

} bemuse wc this 

} dlass -fco be scv-ializjcd- 
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reading and writing files 



Filecross 



any of the cases 


Across 

6. The method in the File class that checks whether or not a 
specific file is on the drive 

9. This statement indicates the end of a case inside a switch 
statement 

10. The abstract class that FileStream inherits from 

11. A nonvisual control that lets you pop up the standard Windows Save 
As dialog box 

15. How you write numbers in base-16 

16. If you don’t call this method, your stream could be locked open so 
other methods or programs can’t open it 

17. The StreamReader method that reads data into a char [] 
array 

18. An encoding system that assigns a unique number to each character 

19. Use this statement to indicate which statements should be executed 
when the value being tested in a switch statement does not match 


Down 

1 ■ This class has a method that writes a type to a file 

2. The static method in the Array class that turns an array backward 

3. The event handler that gets run whenever someone modifies the 
data in an input control 

4. This class has many static methods that let you manipulate folders 
5_ Using this OOP principle makes it a lot easier to maintain your code 

7. If you don’t use this attribute to indicate that a class can be written to 
a stream, BinaryFormatter will generate an error 

8. This BinaryFormatter method reads an object from a 
stream 

12. \n and \r are examples of this kind of sequence 

13. This class lets you perform all the operations in the File class for 
a specific file 

14. This method sends text to a stream followed by a line break 


you are here ► 
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exercise solution 



Filecross 

Solution 
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C#Lab 



The Quest 

This lab gives you a spec that describes a program 
for you to build, using the knowledge you’ve gained 
over the last few chapters. 

This project is bigger than the ones you’ve seen so 
far. So read the whole thing before you get started, 
and. give yourself a little time. And don’t worry if 
you get stuck—there’s nothing new in here, so you 
can move on in the book and come back to the lab 
later. 


We’ve filled, in a few design details for you, and. we’ve 
made sure you’ve got all the pieces you need...and 
nothing else. 


It’s up to you to finish the job. There are too many 
ways to build this lab for us to you a “right” answer. 


But if you need, a hint, other readers have claimed 
their bragging rights by publishing their solutions 
on CodePlex, GitHub, and other collaborative sourc 
de hosting sites. 
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The Quest 



The spec: build aw adventure game 

Your job is to build an adventure game where a mighty 
adventurer is on a quest to defeat level after level of deadly 
enemies. You’ll build a turn-based system, which means the 
player makes one move and then the enemies make one move. 
The player can move or attack, and then each enemy gets a 
chance to move and attack. The game keeps going until the 
player either defeats all the enemies on all seven levels or dies. 


It’s possible to build Windows Desktop programs 
that automatically scale to any size display, but 
that’s beyond the scope of what we’re teaching. 
(You’ll learn all about how to do that with XAML 
in the next chapter, but that obviously won’t 
help with WinForms.) However, this means that 
the inventory PictureBoxes, GroupBoxes, and 
TableLayoutPanel on the form may look right in 
the designer, but end up in strange places when 
you run the program. Just drag them so they look 
right for your screen when you run the program. 


"Uc WmdoM Wcs 扣 0 l cv ^ cad 

v'icy/ o-f d 叫 

Wis 




The playev- tav\ pidk 

up y/c3pohS a 灼 d 

potions alo^ way- 


I he t 

^ -they I 


The enemies jc-t a bit o( advantage— 
■they, move cvc\ry av\d a-P-tcv- -they rwovc 

"they " 匕 k the pbyev* i*f he’s m 


The flayev- ar>d enemies move 
av~ou^d m 七 he 










cre S i\\t \>1 平 r 、 mvenW/. I 七 s ^ OY/s 
v,a-t -rtc^s ?1 平 A ? »tkca up, ay.d 

ray/s a boy. around *tV^c 仏 a 七 

KcvVc £.uV-VCV\*tlY uSm 3* ?^7 cyr 

\\cMs oys itcw' *to »*t, a^a uses 
■V^c butter *to use rtcww 


The game shows you -the ^umbev* 
of hit fomts -Po\r ihc playev 
扣 d c^crwics. W\)^v\ -the playcv 
at'tadks dir> energy，-the enemy’s 
hit pom*ts go down. Otitt the 
hit pom-ts jet dov/h -feo ZjCvo, 
the ChCmy ov- playev- dies. 


"The playc\r moves 
usihg -the -Pouv 
bu*ttohS. 


"Hi esc -fouv buttons 
used bo a-tlatk 

av\A dv-'mk potions. (The 

playcv ^ sc 
-tKcsc buttons *to dv*»y\k 
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The player picks up weapons." 

There are weapons and potions scattered around the 
dungeon that the player can pick up and use to defeat his 
enemies. All he has to do is move onto a weapon, and it 
disappears from the floor and appears in his inventory. 



♦ 


levels da^ay bo *tV^c c^m.cs 




..and attacks enemies with them 

Every level in the game has a weapon that the player can 
pick up and use to defeat his enemies. Once the weapon’s 
picked up, it should disappear from the game floor. 


Player 10 
Bat 6 


* 4 , 攀 


TKc bat *»s bo *tKc r 吵七 d 
\>laycv-) so \\t W»*b 
R — 七 atlatk W*tW 




.Attack 


The attack causes -the 

bats hit pom-ts -fco 
dv*op, -fvorw 厶 "to i’m 
■this dase . 〜 



Higher levels bring more enemies 

There are three different kinds of enemies: a bat, a ghost, and 
a ghoul. The first level has only a bat. The seventh level is the 
last one, and it has all three enemies. 


The bat -Plies 

^rouhd somewhat 
irahdomly. IVhch it s 
⑽ av~ the pbyev-, 
it causes a small 
a^ouh-t o( 






nc 

player 


A ^oul moves <\ui^kly 
Wavd flaycv-, a^d 
causes iicavy da^ay 
y/V^cr^ \i attars. 


^ost moves slov/ly *tov/av-d *tV)C 
A s soor\ 3s its tlosc "to 
played) *>*t attacks a^d causes a medium 
amou\r\*t o-f ddw'dy* 
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舭 ? om-b U 


The design: building the form 

The form gives the game its unique look. Use the form’s 
Backgroundlmage property to display the image of the dungeon 
and the inventory, and a series of PictureBox controls to show 
the player, weapons, and enemies in the dungeon. You’ll use a 
TableLayoutPanel control to display the hit points for the player, bat, 
ghost, and ghoul as well as the buttons for moving and attacking. 


Use the form’s Backgroundlmage property 
to set the background image to the dungeon 
graphic. When you do this, setting controls’ 
background colors to Transparent 
shows the background behind them. Set 
the BackgroundlmageLayout property 
to Stretch and the FormBorderStyle 
property to FixedSingle, then stretch out 
the form until there’s enough room to add the 
GroupBoxes and Buttons to the form. 


The duhjeoh i-tsd-P is a s-tatid \^ay, 
displayed usmj the B 沉 kyoundUage 
pv-opev-iy o-f the -fo\rrw. 


The Quest 


Set the Bd^kj\rouK>dColov* 

pop 饮七 y Oh 七 he (^v-oupBox ahd 

TablcLayoutPahd dohtvols -fco 
T\rahSpa\rCht so the badk^ouhd 
is Visible behind therw. 


Notice hov/ 七 he 'mvcr>*tov*y 
Pid-tuvcBo% dov>*tv*ols, 七 he 
"fablcLayou*tPay>cl 

hi*t 3r>d 七 he 

move a^d attack butto 灼 

^voupBo% do 灼 *brols avc m 

a s 七 va 哼 pladc? Tha 七 ’s 
y/heve v/c V>ad *to dv-a^ 
•them so -they looked 
oy \ ouv sdveer^. 

A 


^C\\ o^c *biicsc idons is d P»^*bu\rcBo%. y o \A C3 iy\ -Pihd the a\rvow ^holv-a^-tcv-s us'ma 

(U^ZI^fO io W+ZI 艿）釙 d paste 

them ih-fco the button Tcx-t pv-opev-ty. 

Download tke background image and tke grapkics lor 
tke weapons, enemies, and player from tke Head First 
LaLs website: www.keactfirstlats.com/tooks/Wcsliarp 


I 七 ’s dc\rtamly possible 
*to build 七 his pvoyam 
so 七 V>a 七 ••七 \rur>s oy \ 3r>y 
display, bu*t 七 hat’s 
beyond 七 he Sdofc o( 
v/ha 七 wcVc 七 eadhi% m 
•this book. IW 七 >wov-v-y, 
-though—>wc1l dc-P*mi*tcly 
show you hov/ *to do 七 ha 七 
y/i*tV> ^mdov/s S*tov*C 
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The Quest 


Everything in the dungeon is a PicturePox 

Players, weapons, and enemies should all be represented by icons. Add You tBy\ sc 七 a Pi^*tu\rcBo^s Ba^kColov- 

nine PictureBox controls, and set their Visible properties to False. p\ropc\r*ty -fco Colov-.T\ra^spa\rci^*t *bo Irt 

Then, your game can move around the controls, and toggle their ba 匕 kyou 的 d pi^*tu\rc ov- to\o>c show 

Visible properties as needed. ^ -thv-oujh d^y *t\ra^spa\rc^*t pixels’m pid*tu\rc. 


口 The Quest 






Mtc, you ve added the Pi.WBox 叫 M : 一 

t A Z £ tu ? ^ $ ，d ° h 3hd Sdcdt I ，匕 I 

Pbv ^ ^ bW. TM: e^su^s 

pbye, ,^o,s stay above a,y \i^s that a，e picked u P . 



The inventory contains PicturePox controls, too 


J\dd nme Pi^WcBo% tontvols *to tV^c 
du^yo^. Use Siz^ properby -to make 

ta cM ortc lOiAO. It does ”’ 七 maUev 

y/V^eve you f>la^e 七 he 你一七 he -fovm y/ill w'ovc 
avo^d- Use little bla^k a^r ⑽ 

七 ha 七 sKov/s y/iiCir\ you c\\tV- oh 
PittuvcBo% *to set tacM *to ortc 

imd^cs -f\rom *tV^C ttedd F»V"S*t Labs v/cbsi*tc* 

f 。士 。| 5 overlap ca^h othev- m the IDE, so -the 
+o … ,eeds k,ow whidh o,es a^e i, W, a,d ■ 

山 UVB— to F,o^| 

的 d Schd "to BaA *Po\nrh desighev- do_ahds do. 


You can represent the inventory of the player as five 50x50 
PictureBox controls. Set the BackColor property of each to Color. 
Transparent (if you use the Properties window to set the property, just 
type it into the BackColor row). Since the picture files have a transparent 
background, you’ll see the scroll and dungeon behind them: 


K_ fSDi 

1/1 

1 备 

m 

曝 i 

!A 


Puild your stats window 


The hit points are in a Table Layout Panel, just like the 
attack and movement buttons. For the hit points, create two 
columns in the panel, and drag the column divider to the left a 
bit. Add four rows, each 25% height, and add in Label controls 
to each of the eight cells: _ 


Youll v\ctd -fwc move 
^0^0 ?\ci\ArSo%ts 
(or *t)ic mven-tov-y. 
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The Quest 


The architecture: usmg the objects 

You’ll need several types of objects in your game: a Player 
object, several subclasses of an Enemy object, and several 
subclasses of a Weapon object. And you’ll also need one object to 
keep up with everything that’s going on: the Game object. 


This is just -the gchcv-al ovcv-vicw. Wc\\ 
give you a lot rho\rc details Oh how the 
pbyev ChCrwics move ； how "the ChCmy 
-figures ou-t i-P its hcair -the player tit. 



TKc -fovm 灼 cvev irrtcvad'ts 

d*iv-ct*tly v/rtii 七 he flaycv-s, 

y/edf 。 灼 s, ov enemies. 


卜 c the mput 4o. 
the +o\rr»» ahd deals wi£h 
仏 c objects i h ihc ^arhe. 


The ^ame object handles turns 

When one of your form’s movement buttons is clicked, 
the form will call the Game object’s Move () method. 
That method will let the player take a turn, and then 
let all the enemies move. So it’s up to Game to handle 
the turn-based movement portion of the game. 

For example, here’s how the move buttons work: 


game.Move () 





W\\cy\ usev- dlitks 
or\t o( -fouv move 
buttons, *tKc -fovm dalls 
MovcO mc*tKod- 


Thcv-c^s o^ly oy\c weapon pev- level, so 
*thc jus*t 灼 ceds a Weapon 

的 o*t a List The Playcv-, howcvcv-, has a 
Lis*t<Wcapoi^> *to hold *thc mvc^*to\ry. 


T\\t 

okjeti keeps 

W\W\ fl3Y cyrS, 

Y/ca^o^s, av\d 3 

list tY\tvr ： \t^ 



1/Vc lef 七 *thc fav-amc*tcv-s ou*t o( -this diayam. 

MovcO method -takes b divc^tioh, a^d 
some c^f *t3kc d R3y>dom objcd*t> *too- 


2. player.Move () 




6{^tf\ts MovcO method 
-Piv-s-t dalls *thc Playcv- 
obje^t’s MovcO method 
b> tell -the playev- -to 眯 ove. 




3 . enemy.Move 




Afic\r the flayev- moves, 
tells cadh o-f the 
ChCrwics -to /VIovcO. 




4. if (NearPlayer()) 

game.HitPlayer(); 



l-P BY\^ O^C *tKc tY\trr：\tS 

tv\d u\> y\cav- *tKc player 
a-P-tev -tVicyvc move 山 
-tVicy a-tiatk ?lay^- 
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&ameplay concerns are separated into the &ame object 


Movement, attacking, and inventory all begin in the form. So clicking a 
movement or attack button, or an item in inventory, triggers code in your 
form. But it’s the Game object that controls the objects in the game. So 
the form has to pass on anything that happens to the Game object, and 
then the Game object takes it from there: ^arwc.AlovcO dal Is -the ehemies ； 

Alov〆）rwethods, all -take 

How moving works … 

H o^^ reC ? 0n - . Rlgh ^^ ( 


a 




TV^c Form ob\cd*t tails i\\t 

/1/lovcw, ay\d tails 
i*|^s ov/k\ U^d3*tcC^3V"3d*tcv~s0 
method *to Ufd3*tc StVCCir\- 





Button 

Wl 

㈧ 七 he —Wrbs a” 

c^cr^Y， \i causes a 'random 
amount damay t> 
a wa 乂 七 ’ 



Use d Pivc^*tior\ -fo\r 
七 he -four butbw dive^biews. 


UpdateCharacters() 




handles updatihg 
lo^tiohs, so y/heh 
u Pd3icCh^adic^0 is 

^ d \ 七 ― a 代 r^oved 
thcilr hew loda-tiohs. 


This Upda"tcChav*ad"tcv*sO method is pavt o( -th 
-fov-rw. H v-cads -the lo^a-tio^ o-P -the player, enemies 
a^d a^y weapons dumpily -the du^^eo^ a^d 
moves ihc Pi 匕 tu\reB<^es “ matdh -them. 




How attacking works 

_(Direction.Right. ^ 

S ', ^ -- 




UpdateCharacters() 


- Attadkm^ is like 

w\ov/CmCrv£. TiiC -foVm 
dalU M*ta 乙 kO ov\ 
6{^t } dy\d 
Kd^dles dcalm^ W\{\\ 
attack. 




1 / 


丁 1 兄 U ydd^c v*3^cv*s () method 

also dhc^ks the playev’s mvc^'fcov-y 
dhd mskes su\rc the ^o\r\rc^i i^o^s 
displayed oy\ the mvc^-fcov-y s^v-oll. 




How the inventory scroll works 

j^ieckPlayerlnventory ( ” ) 


The ihVCh-fco\ry scroll displays 
all o( the i^ohS (or the items 
lha-t the playev- has picked up. 





AH *thc 。七 hc\r v/capo 灼 s’ 
bo\rdc\rs should be - 

*tu\nr\cd o-ff. 



game.Equip("Bow"); 


inventoryBow.BorderStyle = 

BorderStyle.FixedSingle; 



inventorySword.BorderStyle = 

BorderStyle.None; 


TVic Bora^Stylc ^ofc\rty 

W 吵 I 吵 Is attwe rtem I 

i\\t flayers mveyrtov-y* 
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Puildmg the frame class 

We’ve gotten you started with the Game class in the code below. 
There’s a lot for you to do — so read through this code carefully, get 
it into the IDE, and get ready to go to work: 


using System.Drawing; 


Youll and Pom*t -fv-orw 

Sys-tcm.pv-awm^ so be suv-c -to add 
"this -to -the -fcop of you\r dlass. 


class Game { 

public 工 Enumerable<Enemy> Enemies { get; private 
public Weapon WeaponInRoom { get; private set; } 


set 


Tiicsc av-c 0 ^ as 

pv-ofevtics i-f 

a 灼 d Weapon arc >/cll 

y/ov*dS) jus*t w'Skc suv*c 
3 -fovm tar /七 do 
mafpv-opv-ia*tc 


"Hie yrirte keeps a p\riva*tc Playcir object The -fovirw W\W o^ly mtevad 七 

with this ihirouah methods oy\ rather thah di^cdtly. 

private Player player; 1 

public Point PlayerLocation { get { return player.Location; } } 

public int PlayerHitPoints { get { return player.HitPoints; } } 

public 工 Enumerable<string> PlayerWeapons { get { return player.Weapons; 
private int level = 0; 

public int Level { get { return level; } } The Rc 匕 •ba—e obj^t has Tip, Bottom, 

Lc-rt, Ri^h*t -fields, a^d wov-ks 

private Rectangle boundaries ; 之一 - ^ pcv--fcd-tly *ro\r tlic 

public Rectangle Boundaries { get { return boundaries; 


ovcv-all area- 


public Game (Rectangle boundaries) { 如 W 七士 out With a bouhdih0 

this.boundaries = boundaries; _ __ box +ov- the a^d ^v-catcs 

player = new Player (this, \v\ the duh^eoh. 

new Point(boundaries.Left + 10, boundaries.Top + 70)); 


public void Move (Direction direction. Random random) 
player.Move(direction); 

foreach (Enemy enemy A1ovcr»\Ch-t is 

enemy.Move(random); 



Movc^cht is simple ： move the playev- ih the 
div^tioh the -fo\rnr» gives us, av\d r^ove eadh 


ChCi^y ih 3 \rdhdorh di\re 乙 "tioh. 

public void Equip (string weaponName) { 
player.Equip(weaponName); 

<： - 

public bool CheckPlayerInventory (string weaponName) 
return player.Weapons.Contains(weaponName); 

} 

public void HitPlayer (int maxDamage, Random random) 
player.Hit(maxDamage, random); 


These av-c examples 
o( c^apsulatio^.... 

doesn't k 的 o>w 

hov/ Playev- handles 
these attior\s ； i*t jus 七 
passes oy\ -the reeded 
'm-rov-matioir^ Bv\d lets 
Playev- do 七 he v-cst 
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public void IncreasePlayerHealth (int health. Random random) { 

' player. IncreaseHealth (health, random) ; AttadO is almost exactly like /WovcO. 

The playev diiiatks, a^d the e^ies ^11 

jet B tu\rh -fco move. 

public void Attack (Direction direction. Random random) { 
player.Attack(direction, random); 
foreach (Enemy enemy in Enemies) 
enemy.Move(random); 


n (Rando: 


^ctRa^domLodatio^O will m 

七 he NcvaLcvcIO method) v/KiC.K >miII use i*t "to 
y/V^cvc bo plate enemies v/eafem 


private Point GetRandomLocation (Random random) 
return new Point(boundaries.Left + 

random.Next(boundaries.Right / 10 - boundaries.Left / 10) 
boundaries.Top + 

random.Next(boundaries.Bottom / 10 - boundaries.Top / 10) 


★ 


★ 


public void NewLevel (Random random) 
level++; 

switch (level) { 



s just d ma*bh *bridk *to yt a 
>m lod. 


case 


Enemies = new List<Enemy>() { 

new Bat(this, GetRandomLocation(random )), 


This is ^ 

lodd*bio 灼 y/i*thm "the 

*tha*b v-cpv-csc^ts a\rca- 

IVc only added -tiie cast -fov- Level I. Its 
you\r job *bo sdd tBscs -fov- o*thcv- levels. 


WeaponInRoom 
break; 


Finish the rest of the levels 

It’s your job to finish the NewLevel () method. Here’s the 
breakdown for each level: 


new Sword(this, GetRandomLocation(random)); 

斤 r " *to tV,e level 


Level Enemies 


1 

z 

午 

b 

1 

e 


咖 OS*b 

今 houl 

Bat 咖。 s 七 
Ba*t, 与 houl 
今 hos*t, 咖 oul 
Bat 咖。 s*t, ^houl 

m 


So me Wue —r S 今 

Level i, a? 

*tW»s level 


vow 


or\ 


Weapons 

Blue potion 
Bov/ 

Bow, i-f y\o{, picked up oy\ Zj o*t^C\ry/isc, blue potion 
Red potion This ohly appeav-s i-f 

Mace the ired potioh ;。作 

Made, i-f y\o{, Pidkcd UP OY\ ^>； o*thc\rv/isc, \rcd Potion 一 "」 $ has already 

bcch used up. 

N/A - *tiiC v/rth 
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Fmdmg common behavior: movemewt 

You already know that duplicate code is bad, and duplicate code usually 
shows up when two or more objects share the same behavior. Well, you’ve 
got a player that moves and enemies that move, so you’ll need a way to 
avoid having the same movement code duplicated in all of those classes. 

Create an abstract Mover class to put that common behavior into a single 
place. Player and Enemy will inherit from Mover. And even though 
weapons don’t move around much, they have a location and need to be 
placed in the dungeon, so they’ll inherit from Mover, too. Mover has 
a Move () method for moving around the dungeon, and a read-only 
Location property that the form can use to position a subclass of Mover. 


M added \rctu\rh values 

io this 

匕 lass diagv-arn -to make 

-pov you "to see 
oh. 



The Mover class, as well as several other classes, need 
a Direction enum. Create this enum, and give it four 
enumerated values: Up, Down, Left, and Right. 
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The Mover class source code 

You Aa 哼 Move I r\*tcv*val k 

Here’s the code for Mover: ^。认 如扣七 vouv plav c，r a 灼 d c^cw'ics 

-to move m bi^cv- ov- s^allcv- steps. 

abstract class Mover { 

private const int MoveInterval = 10; 


Plsi: 


protected Point location; ^ - 

public Point Location { get { return location; } } 

protected Game game; ^ - — 

— ^ C a/I … 七 he 爲 a 州亡 

public Mover (Game game. Point location) { |r\st 3 ^cs ok A^lovcv . 

this, game = game / a 灼 d a tuv 、 


-vc^-b lodaW. 


this.location 


location 


public bool Nearby (Point locationToCheck, int distance) { 
if (Math.Abs(location.X - locationToCheck.X) < distance && 
(Math.Abs(location.Y - locationToCheck.Y) < distance)) { 


return true; 
else { 

return false 



Nc^vby rwcthod dhcdks d Ponrt 3^3ms-t this objects duV"V"C^*t 

lodaiio^. If ihcyVc wiihm dis-ta^c <Jr eadh othc^ ii 
\rctu\nr>s i\ruc ； othdry/isc, it vciuv-hS -false* 



^ovcO ^dhod 


■bries "to 


州 ovc ohc s-tep 


public Point Move (Direction direction. Rectangle boundaries) 

Point newLocation = location 
switch (direction) { 
case Direction.Up : 
if (newLocation.Y 
newLocation.Y 一 
break; 

case Direction.Down : 

if (newLocation.Y + Movelnterval <= boundaries.Bottom) 

newLocation.Y += Movelnterval; ^ . 

break; ^ t^A »s 


一 Movelnterval >= boundaries.Top) 
: Movelnterval; 


,h a di^-tioh. /-f j-t 
Gh, it \rctiA\rv\s -fchc 
Poi h i hiis ^ 
bouhda^ry, \i ^ hS 
七 he oHjihal Poihi 


case Direction . Left: ou*ts>dc *tV^c kou^d3V"»c s ) 

if (newLocation.X - Movelnterval >= boundaries.Left) ^r-t^c ^ lodat»on 
newLocation . X -= Move Interval; s*taV s *t^c sa^c 3s 

break; stavt*^ 卜七 . 

case Direction.Right : 匕 

if (newLocation.X + Movelnterval <= boundaries.Right) 
newLocation.X += Movelnterval; 

break ； Pmally, this 

default: break; Uaho^ is 

} \rctu\r^cd (y/hidh 

return newLocation;^ - still be 

■the same as 
ihc s-tav-tmj 
lo^atio^O. 
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The Player class keeps track of the player 

Here’s a start on the Player class. Start with this code 
in the IDE, and then get ready to add to it. 


class Player : Mover { 

private Weapon equippedWeapon; 

public int HitPoints { get; private set; 


The Playcv- objects "to 

七丫 inside "the dui^eoh, whidh 
they v\ttd {o km>w -the bou^dav-ics o( ihc 
play'mj a\rca. Use the Coivta’msO r^c-tliod 
"the bouhddV'ies -to make suv-c 

"they Aor\{, rwovc ou-t o( bounds. 


private List<Weapon> inventory = new List<Weapon>(); 
public 工 Enumerable<string> Weapons { 
get { 

List<string> names = new List<string>(); 
foreach (Weapon weapon in inventory) 
names.Add(weapon.Name); 
return names; 



TV lAfeaps ^o^crtY 
a C.oWtthoyy sVmy 

七 V^c weapon 



public Player(Game game. Point location) 
: base(game, location) 

HitPoints = 10; 

} 


"The players dohs-tvu^-fcov- sets 
lii'tPoih'ts *to \0 "tliCh 
ulls the base t\ass dohs-tv-u^-to^. 


Player mV^cvVts 
-(•vow /\ZloVCV") so 

七 Wis passes m 

七 V\c 占 awe ay\d 

lo£.3*b»ov> "to 七 ha 七 

bdsc dl^SS. 


W\\cy\ by\ e^ei 


: my hits -the player 
i"t douses d irdrtdom dmourt't o( 

- ddimd^e- a po-tio^ 

incases 七 he players health, \i 
m£.\rc3scs i*t by d ird^clom dmouirt. 

public void IncreaseHealth (int health. Random random) { 

HitPoints += random.Next(1 , health); 


public void Hit (int maxDamage, Random random) 
HitPoints -= random.Next(1 r maxDamage); 

} 


public void Equip (string weaponName) { 
foreach (Weapon weapon in inventory) 
if (weapon.Name == weaponName) 
equippedWeapon = weapon; 

} 


丁 he E'uipO rwctKodi -tells *tKc playev- *to 

C<^uip OY\t o( his weapons. The 

object ddlls -this method when oy\C o-f 
mvc^*tovy \toy\s is didked. 



A P—b〆 H 1 ” 3 一 

object e— 代 ed at a Wf 


\Afea\>or> 


tr 


By/cr\ -though potions help the f>lay< 
v-athev huvi the c^crwy, ihcyVc 
still toy\i\AcrtA weapons by ihc 
That way the mvc^-toiry be a 
L\si<WcayoY\>, artdl -the tav\ 
pom-t to ov\C v/i-th its Wcapo^l^Roorw 
v-c-Pcv-c^dc. 
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Write the Moved method for the Player 

Game calls the Player’s Move () method to tell a player to move 
in a certain direction. Move () takes the direction to move as an 
argument (using the Direction enum you should have already 
added). Here’s the start of that method: 


TK'is ov\t o-f 

七州 ovcw ^ 七 ku*tW on 
七 k -(*ov*w» is tlitkcd- 


public void Move(Direction direction) { 

base.location = Move(direction, game.Boundaries); 
if (!game•WeaponlnRoom•PickedUp) { 

// see if the weapon is nearby, and possibly pick it up 


^love is ih -the 
■AWir base class. 


You’ll fill in the rest of this method. Check and see if the 
weapon is near the player (within a single unit of distance). 

If so, pick up the weapon and add it to the player’s inventory. 

If the weapon is the only one that the player has, go ahead 
and equip it immediately. That way, the player can use it 
right away, on the next turn. 


<e 


playcm fuiks up a weapon it 

disa PP«ir the duhaeoh 
3hd ih "the ihVCh*tovy. 

/ 

丁 he IVfeapoh ahd -Povm will handle 
-the wcapohs Pi^uvcBox 
Risible wk, -the pi it u P … 

that s "at tk job o-P the Playcv dass. 


Add aw AttackO method, too 


TV v/capo 怕 alUavc a^AttatkO 

广 .e^od ^ takes a P •的十 
a,d a Ra,do. okjedt 
, hiiatVO Will 

Next up is the Attack () method. This is called when one of the \ s cuffed 3v\d ^3^ ^ • 

form’s attack buttons is clicked, and carries with it a direction (again, 个 

from the Direction enum). Here’s the method signature: 、 |jf 七 >/ed^oy> ^ d 

pot»OV\, W\tY\ 

public void Attack (Direction direction. Random random) { vewoves i*t -fv-ow tV'C 

// Your code goes here mvcy\*tov-Y a-rtev- t 

} playcv dhrmks vt. 


If the player doesn’t have an equipped weapon, this method 
won’t do anything. If the player does have an equipped weapon, 
this should call the weapon’s Attack () method. 

But potions are a special case. If a potion is used, remove it 
from the player’s inventory, since it’s not available anymore. 

Potions y/ill implcmc 灼七扣 |Po*tio^ (mov-c oy\ 

\y\ a so you CBy\ use w is” keyv/ovd *to sec i-f d 

IVlcapoi^ is By\ implcw\C^*ta*tio^ <Jc IPcrtioh. 
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Pats, ghosts, and ghouls inherit from the Enemy class 


We’ll give you another useful abstract class: Enemy. Each 
different sort of enemy has its own class that inherits from the 
Enemy class. The different kinds of enemies move in different 
ways, so the Enemy abstract class leaves the Move method 
as an abstract method — the three enemy classes will need to 
implement it differently, depending on how they move. 

abstract class Enemy : Mover { 

private const int NearPlayerDistance 


25 


Enemy 
(abstract) 


HitPoints: int 


Move(random: Random) 
Hit(maxDamage: int, 
random: Random) 


public int HitPoints { get; private set; 
public bool Dead { get { 

if (HitPoints <= 0) return true 
else return false; 


JV -fovm cav\ use i\\\s read-only 
pvopcvty *to see i-f should 

be visible m 


subclass 


public Enemy(Game game. Point location, 

: base(game, location) { HitPoints 


int hitPoints) 
=hitPoints; 



Hr 


public abstract void Move (Random random) 




I/Vh ⑶七 he playev attacks 

如 it 匕 alls 七 he 

enemy’s HiiO mciliod, y/hidh 
d ird^clom humbcir 

-fv-orw 七 he hi 七 po'm-ts. 


public void Hit (int maxDamage, Random random) { 

HitPoints -= random.Next(1, maxDamage); 

} 

- - The dlass *mhc\ri-tcd 七 he Ncav-byO method -Pvom Movcv, 

protected bool Near Player () { \whidh rt 乙扣 use *bo -Pi^uv-c out rt’s *thc playev-. 

return (Nearby(game.PlayerLocation, NearPlayerDistance)); 


protected Direction FindPlayerDirection(Point 
Direction directionToMove; 

if (playerLocation.X > location.X + 10) 
directionToMove = Direction.Right; 
else if (playerLocation.X < location.X - 10) 
directionToMove = Direction•Left; 
else if (playerLocation.Y < location.Y - 10) 
directionToMove = Direction.Up; 


playerLocation) 


else 

directionToMove = 
return directionToMove 


Direction.Down 



l-P you -Peed FihdPlaycvDiv-cdtiohO 
■the flayers loda-tioh, itll use 
f c base dasss lodatioh -field -to 
-figure out whc\rc the flayer is ih 
\rdatioh -to the Chc^y ahd v-ctuv-h 

a that tells you ih 

which di\rc^tioh the ChCmy heeds -fco 

ih o\rdc\r -to move towav-d the 
flayc\r. 
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Write the different Enemy subclasses 


The three subclasses of Enemy are pretty straightforward. Each enemy has a 
different number of starting hit points, moves differently, and does a different 
amount of damage when it attacks. You’ll need to have each one pass a 
different startingHitPoints parameter to the Enemy base constructor, 
and you’ll have to write different Move () methods for each subclass. 

Here’s an example of how one of those classes might look: 

class Bat : Enemy { 

public Bat(Game game. Pointy location) 

: base(game, location. 



^^You p\robably y/or /七 a subclass do^s-t\rud-fco\r 
-Po\r ihese ； the base class handles cvcv-yth'mj. 

public override void Move(Random random) 
// Your code will go here 


The ba 七 s*tav-*b six. h*i*t fomts, so *i*t 
passes 厶七 o 七 he bdse dlass dor>s*tvu£.*tov*. 


subtlssscs 

^ dse m 七认作 

subclasses Mover. 


so 


T\\t ba 七 -flics av-ouhd 
somo/ha 七 v3^domly> 
i 七 uses Random -to -fly 

\y\ a random 

iial-f tirwC. 


Ov\tc tv\trr^l Kas v\0 WXOVC 

i\xt -form will \o^tr display rt. t)ut 

•. ’ list 



y \f playcv ^misKcs i\>t level. X 

hit points. It’ll keep moving toward the J 


The bat starts with six hit p< 
player and attacking as long as it has one or more hit 
points. When it moves, there’s a 50% chance that it’ll move 
toward the player, and a 50% chance that it’ll move in a random 
direction. After the bat moves, it checks if it’s near the player — 
if it is, then it attacks the player with up to two hit points of 
damage. 


I/Vc II have -fco make 
su\rc the -fov-rw 
sees i-p ah ChCr^y 
should be visible 
at cvc\ry tt 


: u\rh. 


The ghost is harder to defeat than the bat. But like the bat, it will only 
move and attack if its hit points are greater than zero. It starts with 
eight hit points. When it moves, there’s a one in three chance that it’ll 
move toward the player, and a two in three chance that it’ll stand still. 
If it’s near the player, it attacks the player with up to three hit points 
of damage. 

The ghoul is the toughest enemy. It starts with 10 hit points, and 
only moves and attacks if its hit points are greater than zero. 

When it moves, there’s a two in three chance that it’ll move 
toward the player, and a one in three chance that it’ll stand still. 

If it’s near the player, it attacks the player with up to four hit 
points of damage. 


The ^hos-fc 

^houl use 
Rdhdom -fco make 
them move move 
slowly thah -the 
playev-. 
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Weapon inherits from Mover; 
each weapon mhcrits from Weapon 


Wcap« 

Wom 


oy\ mV>cv-*rU 
Mow 


because *i*t uses 

We need a base Weapon class, just like we had a base Enemy class. i*U Ncav-byO By\A 
And each weapon has a location, as well as a property indicating MovcO mc*thods *m 
whether or not it’s been picked up. Here’s the base Weapon class: Pama^cEncrwyO. 


abstract class Weapon : Mover { 




Weapon 

(abstract) 


PickedUp 

Location 


PickUpWeapon() 

DamageEnemy() 


public bool PickedUp { get ; private set; 




A pidked uf y/capor\ shouldir / 七 

be dis^ldyed a 个…如 
C-3 k\ use "tVus yt 
atdessov- bo -fijuv-c out- 


public Weapon (Game game. Point location) { 

: base(game, location) 

( Thc ^sbruh>\- alls the /Wovcv- base Covisbruior 

PickedUp = false sets -the game av\d lo^atioh -fields), a^d 

o th ⑶ sets pi^kcdUp to ^alsc (beUuse i 七 

beeh picked up yet). 

public void PickUpWeapon () { PickedUp = true; } 


) 

^csyoY\ s 

Ka»«c 

pvopevt/ 

vc*tuv*y\s 

_rts 

( w Sv/ov(i’ 

w Ma〆 ’， 

w Bov/’). 


^r- 


public abstract string Name { get; 


public abstract void Attack (Direction direction. 



protected bool DamageEnemy (Direction direction, int radius, 

int damage. Random random) { 
Point target = game.PlayerLocation; 

for (int distance = 0; distance < radius; distance++) { 

， foreach (Enemy enemy in game.Enemies) { 

if (Nearby(enemy•Location, target, distance)) { 

enemy.Hit(damage A random); 
return true; 


Y/eapcm 匕 lass \r\ccds *to 

a Name 产 ofevt/ 扣 d a 於 
Atta^kO method detev-mmes 
Kow 七 wC3fo\r\ 乙 ks. 

Random random) ; ( —? 

Bsch y/eafem has a 
v-ar\^c 3r\d 

<Jc atta 乙 k，so 
{}\t v/cafor\S 

i\\t mc-tiiod 

di-f-fcv-cr\*tly- 


target = Move(direction, target, game.Boundaries); 


return false 


The Nearby () method in the Mover class takes only two parameters, 
a Point and an int, compares the Point to the current location, and 
returns true if the Point is near the location. For the DamageEnemy 
calculation, you’ll need to add an overloaded NearbyQ method that 
compares two points and returns true if they’re within the specified 
distance of each other. You’ll also need an overloaded Move method to 
move a Point in a direction and return the new Point. See if you can 
figure out how to modify the Nearby () and Move () methods that we 
gave you so that the overloaded methods don’t duplicate any code. 



TW DamagcEhcrwyO method is 
dip by AiiaM). H aiie^b 
■feo -f'md av\ ih a dev-ta'm 

diV'Cdtioh 3hd Vidius. |*p docs ； i*t 

alls chcmys Hi-tO r^eihod a^d 

^rctuv-hs t\ruc. |-P ho ChCmy^s -fouhd, 
•t \rctu\rhs -false. 
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Piffcrewt weapons attack iw different ways 


Each subclass of Weapon has its own name and attack logistic. Your job is to 
implement these classes. Here’s the basic skeleton for a Weapon subclass: 

^~EaA subclass 

class Sword : Weapon { Y/ca^o^s ： d s^o\rd, oy/, ov- m3 t 


public Sword(Game game. Point location) 
: base(game, location) { } 


Eadh subclass vclics oh the base tlass 
h> do the ihi-tialiia-tioh wo^k. 


public override string Name { get { return "Sword' 


^t\\ yjcsyov\ 

ky\ov/s i*b 灼 aw. 


public override void Attack (Direction direction. Random random) 


// Your code goes here 

The playc\r 乙扣 use the 
v/capo^s ovcir drtd ovcm—-they 
jet dropped or used up. 


K 

丁 he obje 匕七 will pass 

the dilrc^tioh -to sOa^k \y 


Oh 



The sword is the first weapon the player picks up. It’s got a wide 
angle of attack: if he attacks up, then it first tries to attack an 
enemy that’s in that direction. If there’s no enemy there, it looks 
in the direction that’s clockwise from the original attack and 
attacks any enemy there. If it still fails to hit, then it attempts to 
attack an enemy counterclockwise from the original direction of 
attack. It’s got a radius of 10, and causes 3 points of damage. 



The bow has a very narrow angle of attack, but it’s got a very long 
range — it’s got an attack radius of 30, but only causes 1 point 
of damage. Unlike the sword, which attacks in three directions 
(because the player swings it in a wide arc), when the player shoots 
the bow in a direction, it only shoots in that one direction. 


TVmk ^av-c-Pully 
about this...what 
is to the might 
o( the div-edtioh 
Ic-Pt? w^ai is b> 

the Ic-Pt O-P up? 



The mace is the most powerful weapon in the dungeon. It doesn’t 
matter in which direction the player attacks with it — since he 
swings it in a full circle, it’ll attack any enemy within a radius of 
20 and cause up to 6 points of damage. 

t Thc weapo 灼 s will dall m various ways. The 

Matt a-ttadks m all div-c^tio^s, so i-f the flayers {o -the 

V-i^t i*tll ta\\ ZO, ^>, v-a^dom). I-P 

that did^t hit it II attack Up. l-f -thcv-c^s thcv-c, 

i*tll *tv-y Lc-ft, Dovm — makes i*t swi% m a full 匕 iv^le. 
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Potiows implement the IPotiow interface 


There are two potions, a blue potion and a red potion, which increase the 
player’s health. They act just like weapons — the player picks them up in 
the dungeon, equips them by clicking on the inventory, and uses them 
by clicking one of the attack buttons. So it makes sense for them to 
inherit from the abstract Weapon class. 

But potions act a little differently, too, so you’ll need to add an I Pot ion 
interface so they can have extra behavior: increasing the player’s health. 

The I Potion interface is really simple. Potions only need to add one read¬ 
only property called Used that returns false if the player hasn’t used the 
potion, and true if he has. The form will use it to determine whether or 
not to display the potion in the inventory. 

interface IPotion { 
bool Used { get; } 

} / 

IPotioh intakes potiohs 
usable ohly ohde- Its 
also possible -to -p'md 
out i*p a IVcapOh is a 
potioh with U i-p (y/eafoh 
is IPotioh)" bemuse 
this 


Weapon 


IPotion 

(abstract) 


(interface) 

PickedUp 

Location 


Used 

PickUpWeapon() 

DamageEnemy() 






The follows mKcn-t i\\t lVcafor> dass because 
-tiicyVc used just like 一 playev* dlitks 

七 he yohoY\ m sdvoll *to *i*t, Bv\d 

dlidks a^y of aitatk bu 七 W *to u 父 rt. 


RedPotion 


BluePotion 

Name 


Name 

Attack() 


Attack() 



You should be able -to 
w\rrte -these classes usih^ 
this dlass diayam 
七 he ih-povru^'tioh below. 






The BluePotion class’s Name property should return the string 
Blue Potion. Its Attack () method will be called when the 
player uses the blue potion — it should increase the player’s health by 
up to five hit points by calling the IncreasePlayerHealth () 
method. After the player uses the potion, the potion’s Used () 
method should return true. 九 , -^i/, a V)We 

The RedPotion class is very similar to BluePotion, except that its 
Name property returns the string Red Potion, and its Attack () 
method increases the player’s health by up to 10 hit points. 
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The form brings it all together 

There’s one instance of the Game object, and it lives as a private field in 
your form object. It’s created in the form’s Load event, and the various 
event handlers in the form use the fields and methods on the Game object 
to keep the game play going. 

Everything begins with the form’s Load event handler, which passes the 
Game a Rectangle that defines the boundaries of the dungeon play 
area. Here’s some form code to get you going: 


private Game game; 

private Random random = new Random(); 
private void Forml_Load(object sender, 

EventArgs e) { 

game = new Game(new Rectangle(78 A 57 
game.NewLevel(random); 
UpdateCharacters (); 


3 Rcd-fcclhjlc 

You II -Pihd a lot of Rcd-bhglcs ahy 

y° u with WhFoVms. You 
Qh dvwte ohe by passihg it X 
av\d Height values, ov two 
Points ((o\r oppos'rtc do\rhC\rs). Ov\Cc 
you vc got a value, you 

Gh also aucss its Lc-Pt, Right, 

Bottom, as well as iis X 

lVid*th, ahd Height values. 


420, 155)) 



These a\rc the bouhda\rics o( the \y\ the ba^k^v-ouhd 

ir^age you II download Ad add *to the 4 v-m. You may heed -to 
cxpc\rirwcht "to f md 七 he values that -Pit youv- s^v-cch siz^. 


」 

IX! 

m 



!/1 

I 




Rcr^c^bcir -to doubl 卜 did 0h 
Gdh Pid-tuvcBox so -the IDB 
adds a separate cvcht hahdlcv" 

method -Pov o( -them. 


The form has a separate event handler for each of these PictureBox’s Click events. When the 
player clicks on the sword, it first checks to make sure the sword is in the player’s inventory using the 
Game object’s CheckPlayer Inventory () method. If the player’s holding the sword, the form 
calls game . Equip () to equip it. It then sets each PictureBox’s BorderStyle property to draw 
a box around the sword, and make sure none of the other icons has a box around it. 


Move 

f 

i 



PttadK 

_ r 

i 

一 


There’s an event handler for each of the four movement buttons. 
They’re pretty simple. First, the button calls game . Move () with 
the appropriate Direction value, and then it calls the form’s 
UpdateCharacters () method. 

Alake suve you the buttons 

b 沉 k the playev- equips the 
swo\rd, bow, OY 



The four attack button event handlers are also really simple. 

Each button calls game . Attack (), and then calls the form’s 
UpdateCharacters () method. If the player equips a potion, 
it’s still used the same way — by calling game . Attack () — but 
potions have no direction. So make the Left, Right, and Down 
buttons invisible when the player equips a potion, and change the 
text on the Up button to say Drink. 
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The form's UpdateCharactersO method 
moves the PicturcPoxcs into position 

The last piece of the puzzle is the form’s UpdateCharacters () method. Once all the 
objects have moved and acted on each other, the form updates everything.. .so weapons that 
been dropped have their PictureBoxes’ Visible properties set to false, enemies and players 
are drawn in their new locations (and dead ones are made invisible), and inventory is updated. 


Here’s what you need to do: 


O UPDATE TH5 PUAYBE^ P^SITI^>N AND STATS. 

The first thing you’ll do is update the player’s PictureBox location and the label 
that shows his hit points. Then you’ll need a few variables to determine whether 
you’ve shown each of the various enemies. 


public void UpdateCharacters () { 

Player.Location = game.PlayerLocation; 
playerHitPoints.Text = 

game.PlayerHitPoints.ToString(); 


bool showBat = false; 
bool showGhost = false; 
bool showGhoul = false; 
int enemiesShown = 0; 



TV^ shov/Ba 七 variable Will be se 七 *to tv-uc i-f 

破 made bat’s Pi^uvcBo% visible. Same 


// more code to go here... 



UPDATE BACH AND HIT POINTS. 


Each enemy could be in a new location and have a different set of hit points. You need to 
update each enemy after you’ve updated the player’s location: 


foreach (Enemy enemy in game.Enemies) 
if (enemy is Bat) { 


TWis ^ocs 岭七 d W 

todt above. 


bat.Location = enemy.Location; 

batHitPoints . Text = enemy. HitPoints . ToString () ; This will a-P-Pc^t the 
if (enemy.HitPoints > 0) { visibility o-P the ehemy 

showBat = true; _ _—- -- - Pi^tuv-cBox doh-tvols ih 

enemiesShown++; jus-t a bit 


// etc... 



You II heed two mo\rc i-P s-b-tcmchts like -this 

•m you\r 4 代畆 h loop-ohe -fov- -the ghost 
ot\t (or the ghoul. 


Once you’ve looped through all the enemies on the level, check the showBat variable. 
If the bat was killed, then showBat will still be false, so make its PictureBox invisible 
and clear its hit points label. Then do the same for showGhost and showGhoul. 


484 





The Quest 


❺ 


O 


UPDATE TH5 W5AP^>N PICTUEBB^XBS. 

Declare a weaponControl variable and use a big switch statement to set it equal to 
the PictureBox that corresponds to the weapon in the room. 

sword.Visible — false; I\Z\bVc suv-c Y ouV ， 乙 0 灼七 ' 


bow.Visible = false; 
redPotion.Visible = false; 
bluePotion.Visible = false 
mace.Visible = false; 

Control weaponControl = null; 
switch (game•WeaponlnRoom•Name) 
'Sword" : - - 



aicM wamcs. Its easy 
up buy a^rc djW 心七 to 
Vatk dovm 4q d ⑽七 州 aUW 


case 

weaponControl 


sword; break; 


You I! have move -fov* 

從 h wcapoh type. 


The rest of the cases should set the variable weaponControl to the correct control on 
the form. After the switch, set weaponControl .Visible to true to display it. 

SET TH5 VISIBLE PE^PBETY ON BACH INVeNT^EY \COK PICTUEBB^X. 

Check the Game object’s CheckPlayerlnventory () method to figure out whether or not to 
display the various inventory icons. 


O TH5 125ST O? TH5 METHOD. 

The rest of the method does three things. First, it checks to see if the player’s already 
picked up the weapon in the room, so it knows whether or not to display it. Then it 
checks to see if the player died. And finally, it checks to see if the player’s defeated all of 
the enemies. If he has, then the player advances to the next level. 

weaponControl.Location = game•WeaponlnRoom•Location; 
if (game•WeaponlnRoom•PickedUp) 
weaponControl.Visible = false; 
else 

weaponControl.Visible = true; 



^very level V^as OY\t y/ca\>or\. |*f 
\{!s be ⑶ u\>, v/c *to 

make ，乙⑽ mv'isiblc- 


if (game.PlayerHitPoints <= 0) 
MessageBox.Show("You died"); 
Application.Exit(); 

} 



AffkatiorvExi 七 0 immediately <\ui*b i\\t froyam. 
Its pav**t Sys-tcw' lVi^dows.Fov-ms, so you II r\ttA 
•the affv-opv-ia*tc us'mft s*ta*tcmc^*t i-p you v/ar>*t *to 
use i*t ou*tsidc ok a -rovm. 


if (enemiesShown < 1) { 

MessageBox.Show("You have defeated the enemies on this level"); 
game.NewLevel(random); 

UpdateCharacters () ; ^ "thev-c av-c y\o r^ov-c enemies -the 

} IN - - level, the playe/s dc-Pcaicd Hem 

all a^d its -time *to jo *to *tlic 的 e 火 t level. 
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The fuw's just begm^mg! 

Seven levels, three enemies.. .that’s a pretty decent game. But you 
can make it even better. Here are a few ideas to get you started.... 

Make the enemies smarter. 

Gan you figure out howto change the enemies’ Move() methods so that they’re harder to defeat? 
Then see if you can change their constants to properties, and add a way to change them in the game. 

Add more levels. 

The game doesn’t have to end after seven levels. See if you can add more...can you figure out how 
to make the game go on indefinitely? If the player does win, make a cool ending animation with 
dancing ghosts and bats! And the game ends pretty abruptly if the player dies. Gan you think of a 
more user-friendly ending? Maybe you can let the user restart the game or retry his last level. 

Add different kinds of enemies. 

You don’t need to limit the dangers to ghouls, ghosts, and bats. See if you can add more enemies. 

Add more weapons. 

The player will definitely need more help defeating any new enemies you’ve added. Think of new ways 
that the weapons can attack, or different things that potions can do. Take advantage of the fact that 
Weapon is a subclass of Mover-make magic weapons the player has to chase around! 

Add more graphics. 

You can go to www.headfirstlabs.com/books/hfcsharp/ to find more graphics files for additional 
enemies, weapons, and other images to help spark your imagination. 

Make it an action game. 

Here’s an interesting challenge. Gan you figure out how to use the KeyDown event and Timer you 
used in the Key Game in Chapter 4 to change this from a turn-based game into an action game? 

Tkis is your ckance to skow oH! Diet you come up witk a cool new 
version oi tke game? Post it to CoctePlex or anotker project kostingf 
site. Tken join tke Head First C# lo rum and post about it to claim 
your traggingf rigfkts ： kttp ： / / ww.keactlirstlats.com/tooks/kicsliarp/ 
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Taking your apps to the next level ♦ 


HOPB I 

EBMEMBBEBD TO 
BIND MY <&UfTT> 
CObiT^Oi, TO THE 

Spools pe^pbety 


mkf.. 




Ti® 


.El 


^39^r 
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You're ready for a whole new world of app development. 

Using WinForms to build Windows Desktop apps is a great way to learn 
important C# concepts, but there’s so much more you can do with your programs. 
In this chapter, you’ll use XAML to design your Windows Store apps, you’ll learn 
how to build pages to fit any device, integrate your data into your pages with 
data binding, and use Visual Studio to cut through the mystery of XAML pages 
by exploring the objects created by your XAML code. 


this is a new chapter 487 





















finally, a modem look and feel 


Priarfs ruH^mg Windows 8 

Too bad Brian’s old-fashioned, old-style desktop app looks so outdated! 
He’s sick of poking at tiny checkboxes in the desktop. Brian wants his 
excuse generator to be an app. Can we give him one? 


Bviar/s Ma^a^cv- wovks, 

bu 七 us'm^ Ic^ady 1/Vmdov/s 
pvo^vams m dcsk*tof is just 
y\o substitute -Pov* v*cal> ho^cs*t- 

*to-goodr>css, 100 % fuve n. 

W\y\Aovjs S*tov*c affs. 


VOHAT IS THIS, 2003? 
UBT^ &BJ WITH THE 

PBOPUBL 


O 


o 




>□ 


Excuse Manager 



I got a migraine from using Win Forms apps 
Boss totally bought it! 

Last Used Thursday . August 1.2013 QK | 
File date 1/1/2013 8:44:10 PM 



Folder 

Save 

i … Ojoen …… j 

Random 





S 15* 


8:46 PM 
8/1/2013 
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*to yt *tKcsc ideas *m*to youv 
bvd'm -fast? T\)tY\ do -these 七 hnr^s 
bc-fovc s-tclirtm^ *tK'is dhaf*tcv-| 






Windows Store apps are more complex than WinForms programs. That’s why 
WinForms are a really effective teaching tool, but not nearly as effective for 
building killer apps. It’s useful to take a step back and think about how you’re 
learning, because that will help you learn more effectively. Let’s do that now. 



You’ve laid down a good foundation of core knowledge about C#, objects, collections, and 
other .NET tools. Now we’ll get back to building Windows Store apps with XAML. Over the 
next few pages, we’re going to use the IDE to explore the objects that WinForms programs 
create and manage. Try to stay aware of what’s different — and, just as importantly, what’s 
the same — when exploring those objects, and then when you use the IDE to explore the 
objects that make up a Windows Store app built with XAML. 


before you continue ow with this chapter, do these things: 

We spent Chapter 1 and much of Chapter 2 introducing you to building Windows Store apps with 
XAML and the .NET Framework for Windows Store. We’re going to build on knowledge from 
those chapters. If you want the best learning experience, we recommend that you do a few things: 

* Switching gears from WinForms back to XAML is totally fine for some people, but for 
others it’s really jarring. This will help you get these ideas into your brain faster! 

★ Go back to Chapter 1 and build the Save the Humans game again from scratch. This 
time, make sure you type in all of the code. 

* And actually read the code! There are still some things in it that we haven’t covered yet, 
but you should recognize enough of it to start to lay down a good mental foundation. 

* Try to piece together how the game works. Don’t give yourself a hard time, though. Like 
we said, there’s still a lot we haven’t covered yet. 

★ Pay special attention to what you do with the Basic Page template and how you swap it in 
for the default MainPage.xaml, because you’ll be doing that several times in this chapter. 

★ Redo the XAML projects in Chapter 2, too. Even the exercise. Now you’re ready! 

Ov\t wove - 

You haven’t covered 1 00% of what WinForms apps can do. In fact, WinForms has a 
graphics engine called GDI+ that’s capable of surprisingly good graphics, printing, and 
user interaction (but it’s lot more work than doing the same thing in XAML). One of the 
most important ways to learn programming principles is to see the same thing done in 
more than one way. We covered GDI+ graphics in previous editions of Head First C#, which 
we’ve made available on the Head First Labs website as a free PDF. Go have a look! 

http://www.headfirstlabs.com/hfcsharp 


you are here ► 


489 














can you find it? 


Scavenger 

Hunt? 


You've learned a whole bunch of important C# concepts since you built Save the Humans 
in Chapter 1 ， and you’ve gotten plenty of practice using them. Now it’s time to put on your 
detective hat and test your sleuthing skills. See if you can find all of these C# items in the 
Save the Humans code. We got you started with one of the answers. Can you find the rest? 

(Some of these items have more than one correct answer.) 


口 Use a string as a key to look up an object in a Dictionary. 


□ 


Use an object initializer. 


□ 


Add two different types of object to the same collection. 


□ Call 


a static method. 
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口 Use an event handler method. 


□ 


Use the as keyword to 


downcast an object. 


n Pass 


a reference to an object into a method. 


0flnstantiate an object and one of its methods. 

and rts r^e 七 hod is 

called- 


□ 


Use an enum to assign a value. 



you are here ► 
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scavenger hunt solution 



Scavenger 

Hunt? 


You've learned a whole bunch of important C# concepts since you built Save the Humans 
in Chapter 1 ， and you’ve gotten plenty of practice using them. Now it’s time to put on your 
detective hat and test your sleuthing skills. See if you can find all of these C# items in the 
Save the Humans code. We got you started with one of the answers. Can you find the rest? 

(Some of these items have more than one correct answer.) Ti 化 sc arc 七 1^ oy\cs wc 不 ou:d; 

1^ — - you may have -roui^d o*thc\rs| 


0Use 


a string as a key to look up an object in a Dictionary. 


。 1?!? 知 .?.11^. 呼 . 城 ? object m 七卜 c Resources didtohc|\ry. 


Q^Use 


an object initializer. 

The Fv-om, To, BY\d Pura-tioh p\ropev-ties <Jc the 
Double^ihir^a 七 ioh objed 七 Brc ’mrtializjcd v/i*th By\ object 

•mrtializjCV" m /W* 州 a 七 eEher^yO r^e 七 hod. 


EfAdd two different types of object to the same collection. 

•A.?i 私比辦 冰 •(.— 

ih 七 he S 七七与 ar^eO me 七 hod. 


Q^Call a static method. 

Cbvw/bs dass are tailed m 七 he tarexe-t Pom 七 erEjvteredO 

. . ...... . . . . . . . . .... . ... . . 

eve^-t hdhdlev" method. 
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^^Use an event handler method. 

The Pvopev* 七 ies y/ihdoy/ is used *bo By\ even 七 

ha 的 dler method -for 七 he Pom-bcv-Pv-cssedi cve^-t o-f 七 he 

%_ 扣 ” StadkPahel. 


^flJse the as keyword to downcast an object. 

The Resources dittiohav"y has -the -type <objetb, objcd*t>, 
so 七 he retuvh value <Jc ResourdesC u Eher^y7er^pla-te ,， 3 is 
doyjv\tBs{, \x> the spedi-fid *typc Coh-tvolTer^pla-tc. 


E^Pass a reference to an object into a method. 

^ re-fey-ehte Jbo <3 Gpp 七 !? .ojbjc^.ls passed 3s 


0flnstantiate an object and one of its methods. 

Ahim3*tcEher^yO r^ethod, and rts Bc^mO r^e 七 hod is 

called- 


0fUse an enum to assign a value. 

r^e 七 hod *bo set s*t3\rtButto 灼 Visibility *bo 七 he value 

VisibilrtyCollapsed. 



you are here ► 
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windows forms under the hood 


Windows Forms use an object graph set up by the IPE 


When you create a Windows Desktop program, the IDE sets up your form and generates a bunch of code 
in the Forml.Designer.cs file. But what’s actually in that file? There’s no mystery there. You already know that 
each control that’s on your form is an object, and you know that you can store references to objects in fields. 
So somewhere in that generated code is a field declaration for each object, code to instantiate it, and code to 
display it on the form. Let’s go find those lines so we can see exactly what’s going on with your forms. 



Open up the Simple Text Editor project you built in Chapter 9 and open Forml.Designer.es. Scroll to the 

bottom and find the field declarations. You should see one declaration for each control: 

I - ； - 

S Windows Form Designer generated code 


private 

private 

private 

private 

private 

private 

private 


System.Windows.Forms .OpenFileDialog openFileDialogl; 
System.Windows.Forms .SaveFileDialog saveFileDialogl; 
System.Windows.Forms. fextBox textBoxl; 

System.Windows.Forms. Button open; 

System.Windows.Forms. Button save; 

System.Windows.Forms. TableLayoutPanel tableLayoutPanell; 
System.Windows.Forms. FlowLayoutPanel flowLayoutPanel1; 


❺ 


Expand the Windows Form Designer-generated code section and find the code that instantiates the controls: 


private void InitializeComponent() 


The IPS may have 

^c^cv-a*tcd these Irncs 
•m a ovdev-, 

bu 七 should be 

OY\t l*mc -fov cath 
doy>*tvol oy\ -fovm. 


this .openFileDialogl = new System.Windows.Forms .OpenFileDialog( ); 
this .saveFileDialogl = new System.Windows.Forms .SaveFileDialog( ); 
this .textBoxl = new System.Windows.Forms. TextBox (); 
this. open = new System.Windows.Forms. Button (); 
this .save = new System.Windows.Forms. Button (); 

this .tableLayoutPanell = new System.Windows.Forms. TableLayoutPane] (); 
this .flowLayoutPanell = new System.Windows.Forms .FlowLayoutPanel (); 



Controls like the TableLayoutPanel and FlowLayoutPanel that contain other controls have a public 
property called Controls. It’s a ControlCollection object, which in a lot of ways is very 
similar to a List<Control> object. Every control on your form is a subclass of Control, and 
adding it to a panel’s Controls collection causes it to draw itself inside that panel. Scroll down and 
find where the Open and Save buttons are added to the FlowLayoutPanel: 

this .flowLayoutPanell.Controls.Add (this .save); 
this .flowLayoutPanell.Controls.Add (this .open); 


The FlowLayoutPanel is in a cell in the TableLayoutPanel. Find where it and the TextBox are added: 

this .tableLayoutPanell.Controls.Add (this .textBoxl^ 0, 0); 
this .tableLayoutPanell.Controls.Add (this .flowLayoutPanell^ 0, 1) 


Your Form object is also a container, and it contains the TableLayoutPanel: 

this .Controls.Add (this .tableLayoutPanell); 
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c^^rpen your pencil 


designing windows store apps with xaml 


Chaptcir 



Look at the new and Controls. Add () statements that 
the IDE generated for the Simple Text Editor form and draw 
the object graph that they create when they’re executed. 





In 


O Voull ^ccd all tv^csc vouv- 

Y ° w 


rInwiAVQUTPANEL1 
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winforms make great learning tools 
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c^terpen your pencil 


Look at the new and Controls. Add () statements that 
the IDE generated for the Simple Text Editor form and draw 
the object graph that they create when they’re executed. 


rv^c W ^ 0 4 added ^ Co^o\s 

⑽工士 r 


SA V 


广 orm o' 0 


This is bo tome m really Ka 灼 dy >whci^ 
youVc dom^ c%cv*tiscs. Have d look a*t "the 
o*thcv methods m 七 ha 七 Pcbu^ dass, *too. 


Debugging tip 

System. Diagnostics . Debug. WriteLine () 
will write text to the output window while you’re debugging. You can use 
it just like you used Console. WriteLine () in Windows Forms apps. 


"two Bu"t"toh objc^*ts y/CV*( 

added -to the Floy/Layou-tRahcls 

Cohtvols dollcdioh, so it has 

|rc4\rchdcs io both 0( them. The 

also holds \rc-fc\rchdcs -fco 
tKcm ih its opch av\d save -fields. 
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Use the 1I?E to explore the object graph 

Go back to your Simple Text Editor project and put a breakpoint on the call to InitializeComponent () 
in the form’s constructor, then start debugging the program. When it hits the breakpoint, press F10 to step over 
the method. Then go to the Watch window and enter this to explore the object graph. 



: sk 


Watch 1 


Name 

Value 

Type 


° this 

{SimpleTextEditor.For 

nr 

SimpleTextEditor.Forml 


^ base {SimpleTextEditor.Fornr System.Windows.Forms.Form {SimpleTextEditor.F 


o components Cannot fetch the value System.ComponentModel.lContainer 
® ^flowLayoutPane{System.Windows.Forrr System.Windows.Forms.FlowLayoutPanel 
% name null string 

% open {Text = "Open"} System.Windows.Forms.Button 

^openFileDialog^System.Windows.FornrSystem.Windows.Forms.OpenFileDialog 
save {Text = "Save"} System.Windows.Forms.Button 

# =saveFileDialog1 {System.Windows.Fornr System.Windows.Forms.SaveFileDialog 
® MableLayoutPan {System.Windows.Fornr System.Windows.Forms.TableLayoutPanel 
田 MextBoxI {Text = System.Windows.Forms.TextBox 


Clidk + nex •七 *to MJVis 

•to i*t *to see 

all o( -the -fields 七 ha 七 
*tKc IPE *to 

hold *to -the 

-Povm^s dorrbroU. 


Locals Watch 1 


Add a watch for tableLayoutPanell. Controls and expand Results View to see the objects it contains: 


TV>C Coy>*tv*ols tollcd*t'ior> 
dor>*ta*ms *tv/o 
dorrtvoU m 

lablcLayou*tPair>cl 

Flov/Layou-tPa^cl 七 ha 七 
Kolds 七 he Br\d 一 

Save buttons. 



Name Type 


^tableLayoutPanell.Controls System.Windows.Forms.TableLayoutControlCollection 


田 • base System.Windows.Forms.Control.ControlCollection {Sysl 

^ Container System.Windows.Forms.TableLayoutPanel 



s • Non-Public members 
B 0 Results View 

田 • [0] 



田 # n] 


object {System.Windows.Forms.TextBox} 
object {System.Windows.Forms.FlowLayoutPanel} 


Locals Watch 1 


The System. Windows . Form class 
doesn’t actually have a Controls property. 

It inherits that property from its superclass, 
ContainerControl, which inherits it from 
ScrollableControl, which inherits it 
from Control. Keep expanding I 1 - _base 
in the Watch window to move up the 
inheritance hierarchy to System. Windows . 
Forms . Control. (That’s where Form 
inherits its Controls collection.) Expand at the 
Controls collection’s Results View. You’ll 


Expand “base” to see the properties an object inherits from its base class: 


Watch 1 : 


N am e 酸 Collapsed the 

Type 


- V/dlUC GOlUmn TOf — r .. .. 

base ^*, s System.Windows.Forms.Form {SimpleTextEdit< 

三 * base System.Windows.Forms.ContainerControl {Sinr 

三 0 base System.Windows.Forms.ScrollableControl {Sinr 

曰 


base 


System.Windows.Forms.Control {SimpleTextE 


Locals Watch 1 


see an object for each control on the form! 

Tlia 仏 youv last look at l/V'mFo\rms apps -Pov- a -Pcv/ dhaptevs/ lA/cll dome badk -to -them a doufle you are here ► 497 
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let’s explore xaml 

Windows Store apps use XAML to create U1 objects 



命 


When you use XAML to build the user interface for a Windows Store app, you’re building out an object graph. 
And just like with WinForms, you can explore it with IDE’s Watch window. Open the “fun with if-else 
statements” program from Chapter 2. Then open MainPage.xaml cs, place a breakpoint in the constructor 
on the call to InitializeComponent (), and use the IDE to explore the app’s UI objects. 


o 


Start debugging, then press F10 to step over the method. Visual Studio 2012 for Windows 8 has 
a slightly different window layout than VS2012 for Desktop because it has more features, including 
multiple watch windows (which comes in handy when you need to watch many things). Choose 
Debug—Windows—Watch—Watch 1 to display one of the watch windows and watch this: 


Watch 1 



Name 

Type 


曰 (£this^ 

Chapter2Program2.Main Page 



® _ base 

% contentLoaded 


ffl ><changeText 
^enableCheckbox 
^ ^ labelToChange 


Windows.UI.Xaml.Controls.Page {Chapter2Program2.Main Page} 
bool 

Windows.UI.Xaml.Controls.Button 
Windows.UI.Xaml.Controls.CheckBox 
Windows.UI.Xaml.Controls.TextBlock 


\s 








Now have another look at the XAML that defines the page: 

<Grid Background="{StaticResource ApplicationPageBackgroundThemeBrush}"> 
<Grid.RowDefinitions> 

<RowDefinition/> 

<RowDefinition/> 

</Grid.RowDefinitions> 

<Grid.ColumnDefinitions> 

<ColumnDefinition/> 

<ColumnDefinition/> 

</Grid.ColumnDefinitions> 


<Button x : Name="chanqeText n Content^"Change the label if checked" 
HorizontalAlignment="Center" Click= M changeText_Click" / > 

<CheckBox x : Name="enableCheckbox" Content= n Enable label changing" 
HorizontalAlignment= M Center" 工 sChecked= n true n 
Grid.Column= M 1"/> 

<TextBlock x : Name="labelToChange" Grid.Row= M 1" TextWrapping="Wrap" 

Text="Press the button to set my text" 

HorizontalAlignment="Center" VerticalAlignment= M Center" 
Grid.ColumnSpan= M 2"/> 

</Grid> 


Tke XAML 

tkat ctelines 
tke controls 
on a page 
is turned 
into a Page 
otject witk 
iielcts and 
properties 
tkat contain 
references to 
UI controls. 
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o Add some of the labelToChange properties to the Watch window: 


Watch 1 



Name 

Value 

Type 

A labelToChange.Text 

"Press the button to set my text" 

string 

A labelToChange.HorizontalAlignment Center 

Windows.UI.Xaml.Horizon 

A labelToChange.VerticalAlignment 

Center 

Windows.Ul.Xaml.VerticaL 

A labelToChange.TextWrapping 

Wrap 

Windows.UI.Xaml.TextWn ▼ 


The app automatically sets the properties based on your XAML: 

<TextBlock x : Name= M labelToChange n Grid.Row="1" TextWrappinq= M Wrap n 

Text="Press the button to set my text" ^ - 

HorizontalAlignment="Center" VerticalAlignment^"Center" 

Grid.ColumnSpan="2"/> 

But try putting labelToChange . Grid or labelToChange . ColumnSpan into the Watch window. 
The control is a Windows . UI. Controls . TextBlock object, and that object doesn’t have those 
properties. Gan you guess what’s going on with those XAML properties? 


ttovcv- ovc\r Pajc 

0 *to sec its dlass. 

Stop your program, open MainPage. xaml cs, and find the class declaration for Main Page. Take a look at 

the declaration — it’s a subclass of Page. Hover over Page so the IDE shows you its full class name: 


public sealed partial class MainPage 
{ 

public MainPage() 


this.InitializeComponent() 


} 


Page 

class Windows.Ul.Xaml.Controls.Page 

Encapsulates a page of content that can be navigated to. 


Now start your program again and press F10 to step over the call to InitializeComponent () . Go back 
to the Watch window and expand this >> base >> base to traverse back up the inheritance hierarchy. 


Watch 1 


：：：：：：：：：：：：：：：：：：->^ ▼ n 

Name 

Type 



曰 * this 



these 

■to see -the 

supc^lasscs. 


田 


base 
• base 

BSB 


ntent 


Chapter2Program2.MainPage 

Windows.Ul.Xaml.Controls.Page {Chapter2Program2.Main Page} 
Windows.Ul.Xaml.Controls.UserControl {Chapter2Program2.MainPa 
Windows.Ul.Xaml.Controls.Control {Chapter2Program2.Main Page} 


Windows.Ul.Xaml.U I Element {Windows.UI.Xaml.Controls.Grid} 


0 Static mernbers Co 的七⑶七 and i*ts CW\y\do\^s. UI.I.Coh*t\rols.^v~i 


Take a little time and explore the objects that your XAML generated. We’ll dig into some of these objects 
later on in the book. For now, just poke around and get a sense of how many objects are behind your app. 
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old becomes new 


Redesign thc&o Fish! form as a Windows Store app page 

The Go Fish! game that you built in Chapter 8 would make a great Windows Store app. Open Visual Studio 
2012 for Windows 8 and create a new Windows Store project (just like you did for Save the Humans). Over 
the next few pages, you’ll redesign it in XAML as a page that adjusts to different sized devices. Instead of using 
Windows Desktop controls on a form, you’ll use Windows Store app controls on a page. 



This becomes a 

<ScrollViewer/> 


This becomes a 

<TextBox/> 


This becomes a 

<Button/> 



Go Fi 




l/Vel I use a hov-izo^tal StadkPahd 
to youp 七 he av\d 

do^tirols so they ddh 

iirrto the sanr»c dell \y\ 七 he gv-id- 



Your hand 


Start th/g 


Game progress 



Bd asks anyone has a Ten 
Joe has 'D Tens 
Bob has Q Tens 
Ed must draw from the slock. 
Joe asks if anyone has a King 
IBd has 0 Kings 
Bob has {} Kings 
Joe must draw from the stock. 
Bob asks ff anyone has a Four 
Bd has 0 Foura 
Joe has Q Foure 
Bob must draw from the stock. 
9 cards, 
has 7 cards. 

Bob has 9 cards. 

The stock has 7 cards left. 


Two off Spades 
Two of Diamonds 
Two off Hearts 


Seven of Spades 


Seven of Diamonds 
Seven of Hearts 
Ten of Spades 
Ten of Clubs 
Ten of Diamonds 


This becomes a 

.<ListBox/> 


Books 


Bob has a book of Aces 
Bd has a book of Sixes 
Bd ihas a book of Nines 
Bob has a book of Eights 
Joe has a book of Queens 


Ask for a card 



This becomes a 

<ScrollViewer/> 


This is do 的 "brol m *toolbo 乂 . 

I 七 displays a s-tv-mj o( addiM 

vc\rti^3l Br\d /ov ho\riz^^*tal sd\rollbav-s 
i-P -the yov/s lav-yv 
v/mdov/ do^-t\rol. 


This becomes a 

<Button/> 
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Here’s how those controls will look on the app’s main page: 




Go Fish! 


Your Name 


Game progress 


<TextBox/> <Button/> 


Your hand 


Two of Spades 
Two of Diamonds 



utton/> 


/Wost the 
toAt bo 

ik ga^cplay will 

the sa^e, 
but the U| dodc 
will 


〆 


The controls will be contained in a grid, with rows and columns that expand or contract based 
on the size of the display. This will allow the game to shrink or grow to fit the screen. You can 
use the Device window in the IDE to test different screen configurations. 


Go Fish! 



The will 

be playable 



灼 o m 


attev- 



the pajc 
dime^sio^s sre- 


Device .▼ n X 


View 

Visual state 


Display 



圍 

n 

圓 



FullScreenLandscape 
I I Enable state recording 

1366x768 
148dpi @ 100% scale 


10 . 6 " 


Theme Default 

Show chrome 0 

Override scaling 
Clip to display 


The View buttons let you see your page 
in portrait, landscape, and split modes. 

■The different Display options show your page 
in different resolutions and aspect ratios. 

^—Uncheck the “Show chrome” box to turn 
off the picture of the Surface bezel. 
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now that’s a page 

Page layout starts with controls 

XAML and WinForms have one thing in common: they both rely on controls to lay out your page. The Go Fish! page 
has two buttons, a ListBox to show the hand, a TextBox for the user to enter the name, and four TextBlock labels. It 
also has two ScrollViewer controls with a white background to display the game progress and books. 


This is the headev* -from basi£. The badk av-v-ow 
(j) (jO Fish! bu*t*bo^ will disappear, jus*t like i*t did -fov u Savc the Humans. 


Your Name 


① 


Your hand 



Start the game! 



Game progress 



|*f vimdov/ is mddc *t3lt Sdvoll\/ic>MCV 
should yro^i *to -f ill up cx 七 vcv"*ti^l spade* l*t 

should 4isflay sdvollbav-s ^ 七 he it%i yb ioo 




This Sdv-oll\/icwcv- needs *to be *tall 
*bo shov/ various books 
beerf d » s6ovc\red r a^d i*t should aU 。 

display sdvollbavs i-f needed- 





It 

( 

0 





This Lis-tBo^. 
should also yro>N {o 

-Pill up the 

vcviital spade i-f 

the y/mdoY/ is made 

tallcv. 


Ask for a card 


The Basic Page template includes a grid that has two rows. The top row contains the header 
with the app name. The second row holds the contents, which are defined by this grid. This 
whole grid will be contained in row 1 of the Basic Page (it only has one column, column #0). 

"" TKc mav^ms mdcir>*t yr\A so 

•rt’s aliped pay. Ti^c 

“ ,， ^ 〈TextBlock Text= n Your Name" Margin= n 0, 0 r 0 r 20" marjm is always fn<cls. 

3 A Style= n {StaticResource SubheaderTextStyle} n /> 

ta^ -rov tnc yid. V 


<Grid Grid. Row= 


Margin= n 120,0, 60, 60 n > 


We’ll use a StackPanel to put the TextBox for the player’s name and the Start button in one cell: 

<StackPanel Orientation= n Horizontal" Grid.Row= n 1 n > 

〈TextBox x : Name= n playerName M FontSize= n 24 n This adds a ZO-f*i%cl spade 


Width= M 500 M MinWidth= n 300 n / > 

Q〈Button x : Name= ff startButton" Margin= n 20,0 

切 Content= n Start the game! n /> 、— " 、 - 

</StackPanel> 


If 
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Mav^'m fvofC\rty or>ly \\as 
*t>wo v>umbcv*s, 七 hey spcdi-fy 
hov*i2joy>*tal (\t(W 

diY\d vcv-tidal (*tof/bo*t*tom) 
mav-^'rns. 
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參 

Each label on the page (“Your name,” “Game progress,” etc.) is a TextBlock with a small 
margin above it and SubHeader Text Style applied: 

<TextBlock Text= n Game progress 11 

Style= n {StaticResource SubheaderTextStyle} n 
Margin= n 0,20,◦,20 n Grid.Row= n 2 M / > 




A Scroll Viewer control displays the game progress, with scrollbars 
that appear if the text is too big for the window: 

❺ <ScrollViewer Grid.Row= n 3 n FontSize= n 24 M 

Background^"White" Foreground^ 11 Black" / > 


Here’s another TextBlock and Scroll Viewer to display the books. The default vertical and 
horizontal alignment for the ScrollViewer is Stretch, and that’s going to be really useful. 

We’ll set up the rows and columns so the ScrollViewer controls expand to fit any screen size. 

<TextBlock Text= n Books n Style= n {StaticResource SubheaderTextStyle} n 

Margin= M 0,20 f 0 A 20 M Grid.Row= M 4 n /> 

o 

<ScrollViewer FontSize= n 24 n Background^"White" Foreground^"Black" 

Grid.Row= n 5 M Grid.RowSpan= n 2 n / > 








We used a small 40-pixel column to add space, so the ListBox and Button controls need to 
go in the third column. The ListBox spans rows 2 through 6, so we gave it Grid. Row= M 1 
and Grid. RowSpan= M 5" — this will also let the ListBox grow to fill the page. 


dolumr>s s-ta\rt ZjC\to, so a 
doivbrol m 七 he 七 hi\rd doluwm 
has ^\rid-Colun«h— 


❺ 


<TextBlock Text= n Your hand" Style= n {StaticResource SubheaderTextStyle} n 
Grid.Row= n 0 M Grid•Column= n 2 n Margin= n 2◦ n /> 



〈ListBox x:Name= n cards n Background="White M FontSize= n 24 n Height= n Auto n 
Margin= n 0,20 n Grid.Row= n 1 n Grid.RowSpan= M 5 n Grid.Column= M 2 M / > 


The “Ask for a card” button has its horizontal and vertical alignment set to Stretch so 
that it fills up the cell. The 20-pixel margin at the bottom of the ListBox adds a small gap. 

a 〈Button x : Name= M askForACard M Content= n Ask for a card 11 
^ HorizontalAlignment= n Stretch" VerticalAlignment= n Stretch" 
Grid.Row= n 6 n Grid.Column= n 2 n /> 
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it grows, it shrinks —— it’s all good 


Rows and columns can resize to match the page size 




Grids are very effective tools for laying out pages because they help you design pages that can be displayed on 
many different devices. Heights or widths that end in * adjust automatically to different screen geometries. 

The Go Fish! page has three columns. The first and third have widths of 5* and 2*, so they will grow or shrink 
proportionally and always keep a 5:2 ratio. The second column has a fixed width of 20 pixels to keep them 
separated. Here’s how the rows and columns for the page are laid out (including the controls that live inside them): 


〈ColumnDefinition Width="5*7> 


<ColumnDefinition Width="407> 

!〈ColumnDefinition Width="2*7> 


<RowDefinition 

Height="Auto'7> 

<TextBlock/> 

Roy/— u l w -the sedohd V"ov/, 

bedduse v*o>w ^umbev-s s-ta\rt 0. 
i 


<TextBlock 
Grid.Column 邏 "1"/> 

〈RowDefinition 

Height="Auto'7> 

<StackPanel Grid.Row='T'> 

<TextBlock/> 

<Button/> 

</StackPanel> 


<ListBox 

Grid.Column="1" 

Grid. RowS pa n="57> 

This Lis^tBo 乂 spdhs 
•five v-ows, mdludi^ -the 
-Pou\rth \rov/—v/hidh will 
yro^i -to -Pill any -Pv-cc 
spade. This mdkes -the 
L\s{Ro% expand bo -Pill 

Up -the Chii\TC vijh-t- 

side of -the page. 

<RowDefinition 

Height="Auto'7> 

<TextBlock Grid.Row="27> 


<RowDefinition/> 

<ScrollViewer 

Grid Row="3"/> ^ ,s ro>w IS to the dc+ault heijh-t o\ 1^, 

3r\d Sdv-oll\/icv/cv- \y\ i*t is sc*t *bo dc-faul*t 

vcv-ti^al hovizxmtal o-f u S*tvc*td^ w 

so i 七 Ojro^s o\r sWmks *bo -fill up pajc- 


<RowDefihition 

Height="Auto'7> 

<TextBlock Grid.Row="47> 


<RowDefinition 

Height="Auto" 

MinHeight="1507> 

<ScrollViewer Grid.Row="5" Grid.RowSpan="2"> 

This Sdv-oll\/ic>wc\r hds a vow o\ w 2 / -bo syBv\ 

these "two v-ov/s. IVc <\avc 七 he si 火 th v-ow (whidh is 


<RowDefinition 

Height="Auto'7> 

v-ow number ^ m XAML because i^umbcv-mj s*ta\rb 
a*t 0) a hcijli't o( \^0 "to mdke su\rc "the 

Sdv-oll\/ic>wc\r does" 七 y 七 叫 smallev- *tha^ 七 hat 


〈Button 

Grid.Row="6 n 

Grid.Column= n 2 M /> 

/f 



)<AML- v-ov/ BY\d doluwm s*ta\rt 0, so this Button’s v-ov/ is its 乙 oluwm is Z (*to skip the 

middle doluwm). Its vcv-ti^al by\A hov-izjo^tal av-c sc 七 *to S-tv-ctdh so -the button takes up ihc c^*tiv-c 

匕 ell. The v^ow has a hcijht o( Au*to so its height is based the (the button plus its mav-j'rn). 
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Here’s how the row and column definitions make the page layout work: 


<Grid.ColumnDefinitions> 

<ColumnDefinition Width= n 5*▼▼ / > 
<ColumnDefinition Width= n 40 n /> 
〈ColumnDefinition Width= n 2*▼▼ / > 
</Grid.ColumnDefinitions> 

<Grid.RowDefinitions> 


The first column will always 
be 2.5 times as wide as 



the third (a 5:2 ratio), with 
a 40-pixel column to add 
space between them. The 
ScrollViewer and ListBox 
controls that display data 
have HorizontalAlignment 
set to “Stretch” to fill up 
the columns. 






<RowDefinition Height^ 
<RowDefinition Height^ 
<RowDefinition Height^ 

<RowDefinition/> ^ - 

<RowDefinition Height^ 
<RowDefinition Height^ 
<RowDefinition Height^ 
</Grid.RowDefinitions> 


Y^u 匕如 add 七 he \row 

de*f m’rticms above oy below ihc do^ivols m 

七 he yr\d. Wc added 七 k 你 below 七 his time. 

</Grid> 


"Auto"/> 
"Auto"/> 
"Auto"/> 


The fourth row has the default height of 1* 
to make it grow or shrink to fill up any space 
that isn’t taken up by the other rows. The 
ListBox and first ScrollViewer span this row , 

so they will grow and shrink too. 


"Auto"/> 

"Auto" MinHeight= fT 150 ff /> 
n Auto n /> 



Almost all of the row heights are set 
to Auto. There’s only one row that will 
grow or shrink, and any control that 
spans this row will also grow or shrink. 



dlosm^ *foV" ^vid- You II 

by ： m<\ i\\\s all ai t}f\A o( 

■tKc you m’isli povtm^ 

6\o pisV^f b> a l/V’mdov/s £*to\rc app. 



肴 
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pages that work on any screen? inconceivable! 


Use the grid system to lay out app pages 

Ever notice how different Windows Store apps have a similar look? That’s 
because they use a grid system to give every app what Microsoft designers call 
a “consistent silhouette.” The grid consists of squares called units and subunits — and 
you’ve already seen them, because they’re built into the IDE. 

The grid is made up of 20-pixel 
squares called units. 

Each unit is broken down 


If you didn’t use these 
buttons at the bottom of 
the designer to turn on the 
grid lines, snapping, and 
snapping to grid lines back 
in Chapter 1, use them now. 

sssl BS]^ 


The page header 
should be 7 
units tall, with 
the bottom of 
the text 5 units 
from the top of 
the page and \ 
starting 6 units X 
from the left side. \ 


(12C 


into 5-pixel subunits. 


® 


TV V^cadcv- v-o>/ added 

auWa-b^ally *to 

Pay a 七 c r 

^\cM you II add laW *m 

i\\t you 

6jo f w 喊 k”. 


i 

r 

I 

^ r; 

f 


O rl 


Your Name 

_ 


1 


In the Go Fish! app, you use the Margin property in the <Grid> that 
contained all of your controls to create the spacing. The Margin property 
consists of either one number (a thickness value for left, top, right, and 
bottom), two numbers (where the first is left and right, and the second is top 
and bottom), or four comma-separated numbers specifying left, top, right, 
and bottom thickness. 

Your Go Fish! app’s main page has a left margin of 120 pixels (6 units), top 
margin of 0 pixels, and right and bottom margins of 60 pixels (3 units): 

<Grid Grid.Row= n l" Margin =n 120,0, 60, 60 ff > 

It also has a 1 -unit margin above and below each label: 

<TextBlock Text= n Books fT 


The page uses margins to add 1 unit of 
padding between items and text, and 
a column to add 2 units of padding 
between the ScrollViewers and ListBox. 



Style= n {StaticResource SubheaderTextStyle}" 
Margin= n 0 r 20,0,20 n Grid.Row= n 4 n /> 
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there-jave no ^ 

Dumb Questions 


^^,-What does setting the row height or 
column width to “Auto” do? 

When you set a row’s Height property 
or a column’s Width property to Auto, that 
causes the row or column to expand or contract 
so that it exactly fits its contents. You can try this 
out yourself to see how it works. Create a new 
Blank App, edit the grid in MainPage.xaml, and 
add a bunch of rows and columns with heights and 
widths set to Auto. You won’t see anything in the 
designer because the rows and columns are empty 
and collapsed down to zero height. Add controls 
with different heights to the cells, and you’ll see the 
rows and columns expand to fit the controls. 

^^,-So how is that different from setting the 
row height or column width to 1*, 2*, or 5*? 

Using the * for the row height or column 
width causes the rows or columns to expand 
proportionally to fill the entire grid. If you have 
three columns with widths of 3* ， 3* ， and 4^, the 
3 * columns will have a width of 30% of the total 
grid width minus the fixed and auto columns, and 
the 4 * column will have 40% of that total. 

This is one reason why the default width or height 
of 1* makes sense. If all of the rows or columns 
have that default setting, then they will evenly 
distribute themselves as the grid grows or shrinks. 

“Pixels.” You keep using that word. I do 
not think it means what you think it means. 

Many XAML developers use the term pixel, 
but you’re right—technically you aren’t using the 
same kind of pixels you see on your screen. The 
technical term for the numbers in the Margin, 


Height, Width, and other properties is 
device-independent unit. Windows Store apps 
need to work on many different screen sizes and 
shapes, so no matter how big or small a device 
your app is displayed on, each device-independent 
unitwill always be a 1/96th of an inch. Five of these 
device-independent units combine to make a page 
layout subunit, and four subunits make a page 
layout unit. It’s a little confusing talking about units 
for page layout versus device-independent unit, so 
we'll keep using the word pixel to mean device¬ 
independent unit. 

You can specify any XAML height or width 
in different units by adding in (inches), cm 
(centimeters), or pt (points, where a typographer's 
point is 1/72nd of an inch). Try laying out a page 
using inches or centimeters. Then take a physical 
ruler and hold it up to your screen to prove to 
yourself that Windows resizes your app properly. 

Is there an easy way to make sure that my 
app looks good on many different monitors? 

Yes, the IDE gives you useful tools for doing 
that.The IDE’s XAML page designer gives you 
a few different ways to see how your page will 
look on different devices. You can use the Device 
window to show your page in different resolutions 
or split modes. And later on, we’ll show you how 
to run your app in a simulator that lets you interact 
with your app in simulated devices that have 
various sizes and shapes. 

Wken a row or column 
kas a keigltt or wicttk 
ol Auto, tkat tells it 
to g[row or skrink to 
exactly lit its contents. 


You can read more about laying out app pages in the Dev Center: 
http://msdn.microsoft.com/en-us/library/windows/apps/hh872191.aspx 


you are here ► 
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those programs look familiar 



Kci$e 


Use XAML to redesign each of these Windows Desktop forms as Windows Store apps. Create a new 
Windows Store Blank App project for each of them, add a new Basic Page item for each of these apps 
(just like you did for Save the Humans), and modify each page by updating the grid and adding controls. 
You don’t need to get them working. Just create the XAML so they match the screenshots. 




Beehive Management System 



□ Breakfast for Lumberjacks B 


Worker Bee Assignments 

Job Shifts 

Baby bee tutoring v 


Assign this job to a bee 


Report for shift #2(3 

Worker #1 will be done with 'Nectar collector' after this shift 

Worker #2 finished the job 

Worker #2 is not working 

Worker #3 is doing 'Sting patrol'for 3 more shifts 

Worker #4 is doing 'Baby bee tutoring' for 6 more shifts 


Work the next 
shift 


Lumberjack name 


Add lumberjack 


Breakfast line 

1. Ed 
Z Billy 

3. Jones 

4. Fred 

5. Johansen 

6. Bobby , Jr. 


Feed a Lumberjack 

2 g 

O Crispy 
O Soggy 
O Browned 
(§) Banana 

Add flapjacks 
Ed has 7 flapjacics 


Next lumberjack 


Find the right spot in each Basic Page XAML to add your new Grid or 
StackPanel to contain the rest of the controls for the page. You'll add them 
to the second row (Grid. Row= n l n ) of a newly added Blank Page. 

<Grid Style=”{StaticResource LayoutRootStyle} ,r > 
<Grid.RowDefinitions> 

< RowDefinition Height = "140 M /> 
<RowDefinition Height: 1 '* V> 

</GricL RowDef initio ns > ttcv-c s -the <^v-*id> (or this 

l/Vc dollapscd *i*t -the IP£- 

<Grid 


Grid, Row= r, l" Margin=’120 


> 


<!-- Back button and page title --> 

<Grid > Fiv)d this ^orwmch-t dhd 

<Grid.C ： olumnDefinitionsi dd ^ abovc 

<ColumnDefinition Width= ,, Auto"/> 


is -flexible 
a bout tag ovdev- 

^ ^ked you -to add -the )(AML 
Codt -Po\f you\r page layout below 
ik \row dc-Pihi-tiohS because it s av\ 
loGtioh "to -fihd ih you\r XAA1L 
4* _le. Some developers like *fco keep 
the XAAIL Code m the same order 
that its displayed oh the pa^e- 
They rwighi fut it Uhdc\rhcath the 
dlosihg </ ^\d> -tag the gHd 
that doh-taihs -the badk bu-t-toh ahd 

pay "title ihstcad- Wc 
you "to CxpcHmcht with this, 
because it S good io a -Peel 
scenes r^os-fc ih-fcui-fcive -fov- you. 
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Use StackPanels to design this form. It's broken into two groups. Group headers have GroupHeaderTextStyle applied, 
a 40-pixel margin between groups, and a 20-pixel margin after the group header. The labels above the items have 
BodyTextStyle applied, and a 10-pixel margin above the item. There’s a 20-pixel margin between items. 


Beehive Management System 


Worker Bee Assignments 


广 This is a Button with the style 
/ TcxtBu-t-tohStylc applied -to it. 


Baby bee tutoring 


Work the next shift 


Shift report 


Assign this job to a I 


This IS a <ComboBo%>, av\A *I*U rtems 

^■av-c <ComboBox.|*tcm/> v/rth 七 he 

Corrtwt frofwb/ SC 七 *to the I 七加 


Worker vmII be done wth Nectar collector* after this shift 

W6rlter»2 finished the Job 

Worker *2 is not woflang 

Worker #3 is doing Sling p«troT for 3 more shifts 

Worlcer «4 K doing Baby bee tutoring' for 6 more shifts 


ucr luiuruay iui o miiiu 

Use -tKc Cor\i^i f\rofc\rty *to add 七 iVis 

Sdv*oll\/icv/cv*- & 养 11 Will add bvc^ks. H 
a white bov-dev- usm^ Bo\rdc\rTKidkir>css 

a 灼 d Bov*dcv*Bv - usK> 3ir>di 3 o( 2-^0. 


<StackPanel Grid. R ow=T’ Marginal20, 0"> 
<TextBlock/> 


<StackPanel Orientation=“Horizontal”> 


<StackPanel> 

<StackPanel> 

< Button /〉 

<TextBlock/> 

<TextBlock/> 


<ComboBox> 

<TextBox/> 


<Combiboxltem/> 

</StackPanel> 


<Combiboxltem/> 



... 4 more ... 



</ComboBox> 



</StackPanel> 




<Button/> 

<TextBlock/> 

<ScrollViewer/> 

</StackPanel> 


Set the ComboBo^. doirTbrol’s 
Sclcdtcdl^dcy. pv-opev-by -to O 
so _七 displays -the f iv-s-t ite 啪 . 


Use a Grid to design this form. It has eight rows with height set 
to Auto so they expand to fit their contents. Use StackPanels to 
put multiple controls in the same row. 


Breakfast for Lumberjacks 

Lumberjack name 




Breakfast line 


This is a Lis-tBo^c. Ii uses <LisiBoy.|icr»»/> 
"t^s "the s^rwc v/3y "the Cor^boBo% uses 

<ComboBo%|ici^/> tajs. Dcm ’ 七 spcdi-Py a 
licijhi so ii jv-oy/s as iicr»»s avc added. 


1. Ed 

2. Billy 

3. Jones 

4. Fred 

5. Johansen 

6. Bobby, Jr. 



Get your pages to look just like these screenshots by adding 
dummy data to the controls that would normally be filled in using 
the methods and properties in your classes. 


<Grid Grid_Row=T Margin=“120,0”> 

<TextBlock/> 

<TextBox/> 

<TextBlock/> 

<ListBox> 

<ListBoxitem/> 

<ListBoxitem/> 

... 4 more ... 

</ListBox> 

<TextBlock> 

〈StackPanel Orientation=“Horizontal”> 
<TextBox/> 

<ComboBox> ... 4 items ... </ComboBox> 
<Button/> 

</StackPanel> 

<ScrollViewer/> 

〈StackPanel Orientation= ,, Horizontar , > 
<Button/> 

<Button/> 

</StackPanel> 


When you use the IDE’s “New Item …” option to add a Basic Page to your 
project, you might see an error message in the designer because it’s expecting 
the project to be built. Rebuild the solution to make the error go away. 












































exercise solution 




内 Rc»5e 

§OL}itiPH 


Use XAML to redesign each of these Windows Desktop forms as Windows Store apps. Create a new 
Windows Store Blank App project for each of them, add a new Basic Page item for each of these apps 
(just like you did for Save the Humans), and modify each page by updating the grid and adding controls. 
You don’t need to get them working. Just create the XAML so they match the screenshots. 


ttev-e’s 七 he mavj'm y/c you. Ledv'm^ o-P-P 

<StackPanel Grid.Row= M l M Margin= n 12 0,0"> the \rijlrt dhd bot-fcom dduses them {p 

<TextBlock Text= M Worker Bee Assignments" r^imrov* ihc -top a^d Ic-Pt (IZO a^d O). 


Style="{StaticResource GroupHeaderTextStyle}"/> 
<StackPanel Orientation= M Horizontal" Margin="0,20,0,0"> 


<StackPanel Margin="0,0,20,0"> 

<TextBlock Text="Job" Margin= n 0,0,0,10 n 

Style= M {StaticResource BodyTextStyle}"/> 


<ComboBox Selectedlndex="0 ▼，> 

<ComboBoxItem Content="Baby bee tutoring" / > 
<ComboBoxItem Content="Egg care" / > 

<ComboBoxItem Content="Hive maintenance" / > 
<ComboBoxItem Content="Honey manufacturing" / > 
<ComboBoxItem Content="Nectar collector" / > 
<ComboBoxItem Content="Sting patrol"/> 

</ComboBox> 

</StackPanel> 

<StackPanel> 

<TextBlock Text="Shifts M Margin="0,0,0,10▼' 

Style= M {StaticResource BodyTextStyle}"/> 

<TextBox/> 


Does your XAML code look 
different from ours? There 
are many ways to display 
very similar (or even 
identical) pages in XAML. 


</StackPanel> 


<Button Content="Assign this job to a bee" Margin= n 20,20,0,0 n 
Style="{StaticResource TextButtonStyle} M / > 

</StackPanel> Tins is iicsdcv -fov 

〈Button Content= M Work the next shift" Margin= n 0,20,0,0 n / > yro\A^, W\{\\ 3 

3bovc 2-^ 

<TextBlock Text= M Shift report" Margin= n 0,40,0,20 n ( - pi%cl below- 

Style="{StaticResource GroupHeaderTextStyle}"/> 

<ScrollViewer BorderThickness="2" BorderBrush="White" Height= M 250" 

Content=" 


Report for shift #20&#13; 

Worker #1 will be done with 'Nectar collector A after this shift&#13; 


Worker #2 finished the job&#13; 

Worker #2 is not working&#13; 

Worker #3 is doing 'Sting patrol r for 3 more shifts&#13; 
Worker #4 is doing 'Baby bee tutoring' for 6 more shifts 

"/> 


</StackPanel> 




-the dummy daia we used 
"to populate ihc shi-f-t \rcpovt. 
The pmopev-ty ig^ov-cs 

Ime breaks — we added -them -to 
-the solution casicv- -to v-cad- 
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<Grid Grid.Row="1" Margin= n 120,O n > 

<Grid.RowDefinitions> 

<RowDefinition Height="Auto" / XRowDefinition Height= M Auto M / > 

<RowDef inition Height="Auto" / XRowDef inition Height= M Auto M / > ^ 1/Vc \rCrwovcd Imc 

<RowDef inition Height="Auto" / XRowDef inition Height= M Auto M / > V b\rc3ks -to make "the 
<RowDef inition Height="Auto" / XRowDef inition Height= M Auto M / > J dc*f mi-tio^s -fi-t 
</ Grid. RowDef ini t ions > ) o 灼七 his paje. 


<TextBlock Text= M Lumberjack name" Margin="0,0,0,10" 

Style="{StaticResource BodyTextStyle}"/> 
<TextBox Grid.Row="1"/> 


<TextBlock Grid.Row="2" Text= M Breakfast line" Margin= n 0,20,0,10 

Style="{StaticResource BodyTextStyle}"/> 


<ListBox Grid.Row= M 3"> 

<ListBoxItem Content: 
<ListBoxItem Content: 
<ListBoxItem Content: 
<ListBoxItem Content: 
<ListBoxItem Content: 
<ListBoxItem Content: 
</ListBox> 


2 

3 

4 

5 


Ed M /> 
Billy n /> 
Jones"/> 
Fred" / > 
Johansen" / > 
Bobby, Jr 


just be 100% c\t^ wc asked you b> add 
七 kse dummy i-tems as pairt o( iht cxcv-disc, 

， the -Po\rrh look like its used- 
/ou \re about -to lca\fh how -to bihd ^ohtv-ols 
like this ListBox -fco p\ropc\rtics ih youv- classes. 


<TextBlock Grid.Row="4" Text= M Feed a lumberj ack" Margin= n 0,20,0,10 

Style="{StaticResource BodyTextStyle}"/> 

<StackPanel Grid.Row= M 5" Orientation= M Horizontal n > 

<TextBox Text="2" Margin= n 0,0,20,0"/> 

<ComboBox Selectedlndex= n 0 n Margin= n 0,0,20,0 n > 

<ComboBoxItem Content= n Crispy" / > 

<ComboBoxItem Content:"Soggy"/> 

<ComboBoxItem Content="Browned" / > 

<ComboBoxItem Content="Banana" / > 

</ComboBox> 


<Button Content= M Add flapjacks" Style="{StaticResource TextButtonStyle}"/> 
</StackPanel> /Wov-c dummy 

<ScrollViewer Grid.Row="6" Margin= n 0,20,0,0 n Content= M Ed has 7 flapjacks" 

BorderThickness="2" BorderBrush="White" / > 


<StackPanel Grid.Row= M 7" Orientation="Horizontal" Margin= n 0,40,0,0▼，> 

<Button Content="Add Lumber j ack" Margin= n 0,0,2 0,0 ▼’ / > 

<Button Content="Next Lumberj ack" / > 

</StackPanel> 

What do you think of this page layout? Would 
it make more sense to move the Add and Next 
buttons into a standard Windows 8 app bar? 


</Grid> 
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no more dummy data 


Pata bmdmg connects your XAML pages to your classes 

Your TextBlocks, ScrollViewers, TextBoxes, and other controls are built for displaying data. When you were 
using WinForms, you had to use properties to display text or add list items. That will work with XAML too, 
but there’s another way: you can use data binding to automatically populate the controls on your page with 
data. Even better, you can also use data binding to have your controls update properties in your classes. 



DATA CONTEXT 


TV^c data >s just 

a normal rt^ect^u, us’” 
a ?\rft7 oy ' 七 ^ 6 °^° 
tailed PataCo^c%i 



BINDING 


》et 




Context, path, and binding 



Q’Q oh'\^ 


Data binding only works with 
properties. If you try to bind 
to a public field, you won’t 
see anything — and you 
won’t get an error, either! 


Data binding in XAML is a relationship between the source property of an object 
that feeds data to a control and the target property of the control that displays the 
data. To set up data binding, the control’s data context must be set to a reference 
to the data object. The binding for the control must be set to a binding path ， 
which is the property on the object to bind to. Once these things are set, the control 
will automatically read the source property and display the data as its content. 


The bmdmg fa*th (or this 
7c>c*bBlo^k do^*tv-ol is the 


Cash pv-ofev-ty. I 七 will 
display the value o( Cash 
-Pov- whatever objedt its 
bou^d *to. 


To set up data binding in XAML, set the property that you want to bind to {Binding Path} : 

<TextBlock x : Name= n walletTextBlock n Text= n {Binding 


\1/ 

Cash} n /> 


Then you just need an object to bind to — in this case, a Guy object named j oe whose Cash property is set to the 
decimal value 325.50. Giving the TextBlock’s DataContext a reference to the Guy object sets up the context. 

Guy joe = new Guy( n Joe n , 47, 325.50M) ; The data (or this Tc>ctBlodk 

is a v-c-Pcv-c^dc b> a 今 uy object 

walletTextBlock. DataContext = joe; The T^tBl 芦 k will \rcad a^y bou^d 

pv-opcv-tics -Pvorw the 今 uy object 

Now your binding is set up! You’ve set the data context to an instance of Guy, you’ve set the binding path to the Cash 
property. The TextBlock sees its binding is set to Cash, then looks for a property called Cash on its data object. 

You can actually leave out the path and just set the property to {Binding}. In this case, it will call the Guy object’s 
ToString () method. 
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Two-way binding can get or set the source property 

Binding can read data from the data object. It can also use two-way binding to modify the source property: 


<TextBox x : Name= n ageTextBox n Text= n {Binding Age, Mode=TwoWay} n /> 

This TextBox’s binding path is the Age property, and the binding is set to two-way mode. When the page is 
displayed, the TextBox will show the value of the Age property of whatever object it’s bound to. If you change 
the value in the TextBox, the control will call the Age property’s set accessor to update the value. 



Piwd to collections with ObservableCollection 


Data binding is built to cause 
you as few headaches as 
possible. If you set the binding 
path to a property that isn’t in 
the data context, it won’t display 
or set any data, but it also won’t 
cause your program to break. 




Some controls like TextBlock or TextBox display a string. Other controls like ScrollViewer display content from an 
object. But you’ve also seen controls that display a collection: ListBox and GomboBox. That’s why .NET comes 
with ObservableCollection<T>, a collection class that’s built specifically for data binding. It works a lot like 
List<T> (you’ll see it in action on the next page). 

mxamtMim, W\\CV\ VOU bind 


BINDING 

工 temsSource= n {Binding}" 


irvhc^ you bi 
七 he Lis-tBo^ s 
|-tcrwsSouv*£.c 

Obsc\rvablcCollcdtio^ 
•rt displays all of 
七 he i-terws \ y \ -the 

匕 oil cation. 


Use code for binding (without using any XAML at all!) 


If you examine a control, you won’t actually see a property called Binding. There’s no direct way in G# to 
get a reference to a property on an object, just the whole object. When you create the XAML code for a data 
binding, it sets up the binding using an instance of a Binding object that stores the name of the target 
property as a string. Here’s code-behind that creates a Guy object, then sets up binding for a TextBlock called 
walletTextBlock so its Text property is bound to the Guy object’s Cash property. 


Guy joe = new Guy( M Joe M r 47 r 32 5.50M); 
Binding cashBinding = new Binding(); 
cashBinding.Path = new PropertyPath("Cash"); 
cashBinding.Source = joe; / 


Thcv-c ; s a dlass called Dcpc^dc^dyPv-opcv-ty, 
and "the Tc>c-tBlodk dlass has a whole 
o( s-taiid pv-opcv-tics -that av-c o-P 

it Oy\t o( -them is called Tc^-tPv-opcv-ty. 


walletTextBlock.SetBinding(TextBlock.TextProperty, cashBinding); 


you are here ► 
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I can’f contain my excitement 


XAML controls caw cowtaiw text … awd more 


Let’s talk a little more about XAML markup (that’s what the M in XAML stands for, and it refers to the 
tags that define the page) and code-behind (the code in the .cs file that’s joined with the markup). 


When you use a Grid or StackPanel control, you add the controls that they contain between the opening 

and closing tags. You can also use the same thing for other kinds of controls. For controls like TextBlock 

and TextBox, you can set the Text property by adding text and a closing tag: Th.s .is .ust like us*m^ 

<TextBlock>This is the text to display</TextBlock> Tc%*t fvofc\rty. 


When you do this, you’ll use <LineBreak/ > instead of &#13; to add line breaks. What you’re really 
doing here is specifying the Unicode character U+0013, which is interpreted as a line break. You can also 
specify it in hex: &#xD; gives you a line break, &#xA3 ; gives you a £ character (remember Gharmap?). 


<TextBlock>First line<LineBreak/>Second line</TextBlock> 


Try adding that TextBlock to a XAML page, then use Edit Text to edit it and press Shift-Enter to add a 
break. The IDE will add this: 


<TextBlock> 

<Run Text= n First line n / > 

<LineBreak/> 

<Run Text= n Second line n / > 

</TextBlock> 

All three of those options may look the same on the screen, but they create different object graphs. Each 
<Run> tag is turned into its own string object, and each of those strings can be given its own name: 

<Run Text= n First line” x : Name= TT firstLine TT /> 

You can use this to modify that string in your G# code behind the XAML form: 

firstLine. Text = "This is new text for the first line TT ; 

Content controls like ScrollViewer have a Content property (instead of a Text property) that doesn’t 
have to be text — it can contain any control. And there are many content controls. One useful one is 
Border, which you can use to add a background and border to controls like TextBlock that don’t have 
one: 


<Border Background= n Blue TT 

Bo rderBrush= n Green TT 
</Border> 


S£.V"oll\/icv/C\r mhev-its -fvorw 

v/hidh is -the sdme 


匕咖 "brol you used "to dvcaic youv 
Save 七 he Hu^a^s. Youv 
Co^ic^-tCo^iv-ol CoY\{^\v\td a ^v-id, 

whi 匕 h dojvtamed -thv-cc Ellipses. 


BorderThickness= TT 3 n > 
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tWeiqre no o 

Dumb Questions 


^^,-My page had a Grid that contained another Grid, which 
contained a StackPanel. Is there a limit to how many controls can 
live inside other controls? 

No. You can nest controls inside of other controls, and those 
controls can in turn contain additional controls. In fact, later on in the 
book you’ll learn about how to build up your own controls by starting 
with a container and adding content to it. You can put a Grid into any 
content control—you already did this once when you created the 
enemy out of a Grid and three Ellipse controls in Save the Humans. 
That’s one of the strengths of using XAML to design your apps: it gives 
you the ability to create complex pages out of simple controls. 

^^,-lf I can lay out the same page using either a Grid ora 
StackPanel, which one should I use? 

depends a lot on the situation. There is no “right” answer: 
sometimes it makes more sense to use a StackPanel, sometimes 
it makes sense to use a Grid, and sometimes it makes sense to 
combine them. And those aren’t the only options, either. You used a 
Canvas in Save the Humans, which is a container control that allows 
you to use the Canvas . Left and Canvas . Top properties 
to position controls at specific coordinates. All three of these controls 
are subclasses of Panel, and among the behaviors they inherit from 
that base class is the ability to host multiple other controls. 

Does that mean there are controls that can only host a 
single control? 

Yes. Try adding a Scroll Viewer to a page. Then nest two other 
controls inside it. Here's what you’ll see: 

<ScrollViewer> 

<TextBox/> 

<Button/> 

</Sc 

The property 'Content' is set more than once. 

That’s because this XAML sets the Content property on the 
ScrollViewer object, and that property is of type obj ect. If 
you replace the ScrollViewer tags with Grid tags: 

<Grid> 

<TextBox/> 

<Button/> 

</Grid> 

This will work just fine, because the contained controls are added to a 
collection called Children. (Your code in Save the Humans used 
the Children collection to add enemies.) 


Why do some controls like TextBlock have a Text 
property instead of a Content property? 

Because those controls can only host text, so they have a 
string property called Text instead of an obj ect property 
called Content. This is called the default property of the control. 

The default property of a Grid or StackPanel is its Children 
collection. 

Should I be typing in my XAML code, or using the IDE's 
designer to drag controls out of the toolbox? 

You should try both, and do what’s most comfortable to you. A 
lot of developers rely heavily on the designer in the IDE, but many 
developers rarely use the designer at all because they find it faster 
to type the XAML. The IDE’s IntelliSense makes it especially easy to 
type XAML. 

Remind me again why I had to learn WinForms? Why 
couldn’t I just jump straight to XAML and Windows Store apps? 

Because there are a lot of concepts that make XAML much 
easier to understand. Take the Children collection, for example. 

If you didn’t understand collections, would the answer to the third 
question on this page make sense? Maybe. But it’s a lot more obvious 
once you do understand collections. On the other hand, it’s really 
easy to drag controls out of the toolbox and onto the form. There’s a 
lot less depth to WinForms than there is to page design with XAML 
(which makes sense, since XAML is a much newer and more flexible 
technology). Spending several chapters on WinForms made it easy 
for you to get the hang of designing visual applications and building 
interesting projects. That, in turn, helped you get many of these 
concepts into your brain. You’ll absorb XAML much faster now that 
you have them there. There’s also a lot of value in seeing the same 
project done two different ways. That’s why we’re revisiting some of 
the projects from previous chapters: you’ll understand more about 
both WinForms and Windows Store apps by seeing the same app 
done in both. 

WinForms is a great tool lor learning 
and exploring C#，Wt XAML is a 

muck more capable tool lor tuilctingf 
llexitle and elective apps. 

you are here ► 
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sloppy joe meets windows store 


Use data binding to build Sloppy Joe a better mm 

Remember Sloppy Joe from Chapter 4? Well, he’s using Windows 8 now，and he wants a 
Window Store app for his sandwich menu. Let’s build him one. 


Here’s the page we’re going to build. 

It uses one-way data binding to populate a ListView and a Run inside a TextBlock, and it uses 
two-way data binding for a TextBox, using one of its <Run> tags to do the actual binding. 



We’ll need an object with 
properties to bind to. 

The Page object will have an 
instance of the MenuMaker class, 
which has three public properties: 
an int called NumberOf Items, 
an ObservableCollection 
of menu items called Menu, 
and a DateTime called 
GeneratedDate. 


MenuMaker 






NumberOfltems)^^^^, 
乂 Menu 



GeneratedDate 
UpdateMenuQ 


e ^fi/oc^° 



e ^fiox 
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The Page object creates an 
instance of MenuMaker and 
uses it for the data context. 

The constructor for the Page 
object will set the StackPaneFs 
DataContext property to an 
instance of MenuMaker. The binding 
will all be done in XAML. 


Menultem 

Meat 

Condiment 

Bread 

override ToStringQ 


^ Simple 

objcd*U> ovcv-vidm^ 

ToStv-'m^O method b> sc*t 
-tKc 七 dm 七 he LisWiom. 


The Lis*t\/icy/ 

a^d Tc^-tBlodk 
objedts arc 
also bou^d *to 
p\rofC\rtics m 

the Alc^uAlakcv 
object- 


Pg 沪 


Menu 


The TextBox uses two-way 
binding to set the number of 
menu items. 

That means the TextBox doesn’t need 
an x : Name property. Since it’s bound 
to the NumberOfI terns property in 
the MenuMaker object, we don’t need 
to write any G# code that refers to it. 


严 fiox 0 


The tv/o-v/ay bmdmg 
-Pov- -the Tc'/.iBo% 

rwc 扣 s i*t 

initially popula 七 ed 
with 七 he value m 
the hfumbe\rO^HennS 
\>^ro\>c\riy, av\d 

updaics ihai 
p\ropcv-ty y/hcK>cvc\r 
七 he usev* edrts 七 he 
value "m 七 he 


The button tells the MenuMaker to update. 

The button calls the MenuMaker ? s UpdateMenu () 
method, which updates its menu by clearing the 
ObservableCollection and then adding new Menultems 
to it. The ListView will automatically update any time the 
Ob servableCol lection changes. 


Here’s a coding challenge. Based on what you’ve read so far, how much of the new and 
improved Sloppy Joe app can you build before you flip the page and see the code for it? 


you are here ► 
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❶ Create the new project and replace MainPage.xaml with a Basic Page. 

Create a new Windows Store app. Then delete MainPage.xaml, and add a new Basic Page called 
MainPage.xaml to replace it. You’ll need to rebuild the project after you replace the page. This is 
exactly the same thing you did with Save the Humans (flip back to Chapter 1 if you need a refresher). 


❺ 

Jus 七 浐吵 七一 didk 
oy \ -the pvojcdi 

m the 

Solution £>cplovcv- 
dnd ddd d hCV/ - 
dass, just like 
you did v/i-th 
othev- pirojcdts- 


II use data 
bi^d'ma -fco display 
dd'td -rv-orw -these 
p\ropcv-tics oy \ 
youv pay. Y^u II 
also use iwo-v/ay 
b’md’mg "to update 
hfumnbe\rO^HerinS. 


Add the new and improved MenuMaker class. 

You’ve come a long way since Chapter 4. Let’s build a well-encapsulated class that lets you set the number of 
items with a property. You’ll create an ObservableCollection of Menu Item in its constructor, which is 
updated every time the UpdateMenu () is called. That method will also update a DateTime property called 
GeneratedDate with a timestamp for the current menu. Add this MenuMaker class to your project: 

using System .Collections . Obj ectModel; ^ - \4u1l Y\ttd -this us’rng I'me because 

Obsc\rvablcColl^tioh<T> is m this 

class MenuMaker { 槪 

private Random random = new Random(); 

private List<String> meats = new List<String>() 

{ "Roast beef n , "Salami ", "Turkey ", "Ham ", "Pastrami" }; 

private List<String> condiments = new List<String>() { "yellow mustard ", 

"brown mustard ", "honey mustard ", "mayo ", "relish ", "french dressing" } 
private List<String> breads = new List<String>() { "rye ", "white ", "wheat ", 

"pumpernickel", "italian bread", M a roll" }; 

public ObservableCollection<MenuItem> Menu { get; private set; } 

public DateTime GeneratedDate { get; private set; } 

public int NumberOfItems { get; set; } 

public MenuMaker () { 

Menu = new ObservableCollection<MenuItem> () ^ Cvcaic/Wc^ulW) method 

\rctuv-hs Me 灼 ultcm objedts, jus-t 
s-tv-'mjs. That v/ill r^akc it casiev- b> 

^ 七 he way items avc displayed i-P v/c 



NumberOfItems 
UpdateMenu(); 


10 


private Menultem CreateMenuItem() { 

string randomMeat = meats[random.Next(meats.Count)]; 
string randomCondiment = condiments[random.Next(condiments.Count)]; 
string randomBread = breads[random.Next(breads.Count)]; 
return new Menultem(randomMeat, randomCondiment , randomBread); 


public void UpdateMenu() { 

Menu.Clear(); 

for (int i = 0; i < NumberOfItems; i++) 
Menu.Add(CreateMenuItem()); 

} 

GeneratedDate = DateTime.Now; 


_ a dos 饮 look a-t how this 
^ ^orks. H hcvcv actually Scales 
{ a hCW Mchultcr^ ^ollcdtioh. It 

updates -the duv-vcht ohc by 

i*t and dddihj hew i*tcrws. 


l/Vha-t happens i-P -the 

l^(Armbc\rOrHcrnS is set 
io a negative ^u^bev-? 
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Wse D9*tcTir»»c -to wovk dates 

/oU ； C f Cad V CCh , thC ^ lets you sue a date, /ou also 

r dales a,d tir.es. H has a static p^opjy called 

Jit f 11 aU ° ^ " cihods likc Addl JldsO “ 

P T " dS， " illisc ^ ^ pities like ttou, 
ahd to bw dovm tk d 如 .fU Wly/ 
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❺ Add the Menu Item class. 

You’ve already seen how you can build more flexible programs if you use classes instead of 
strings to store data. Here’s a simple class to hold a menu item — add it to your project, too: 


class Menultem { 

public string Meat { get; private set; } 
public string Condiment { get; private set; } 
public string Bread { get; private set; } 

public Menultem(string meat, string condiment 
Meat = meat; 

Condiment = condiment; 

Bread = bread; 


public override string ToString () 


return Meat 


with 


Condiment 


on 



The st\rihgs that 
你 ake up the item av-c 
passed ih*to "the ^ohS't\rud'fcov* 
held ih \rcad—Ohly 
au-torwcl-tid properties. 

string bread) { 

Override the 

~fo^br\y\^0 wthod so 

"the A1cK>u/*tcrn khows 
how ■{» display i-tscl-f. 

+ Bread; 



❹ Build the XAML page. 

Here’s the screenshot. Gan you build it using StackPanels? The TextBox 
has a width of 100. The bottom TextBlock has the style Body Text Style, 
and it has two <Run> tags (the second one just holds the date). 


pem’t add dummy da*ta 
■(jVis Wic , ll lc*t 

do us. 


Welcome to Sloppy Joe's 


Number of items 


Make a new menu 


Vov\i -Povjct *to se 七七 he A??Na^e m the 
<Rajc Rcsouv£.cs> section at the "top o( 

七 he pajc -to the page headev- *twt. 


Ham with yellow mustard on rye 


Ham with brown mustard on pumpernickel 


Turkey with brown mustard on a roll 


Roast beef with mayo on rye 


Pastrami with yellow mustard on a roll 


Salami with brown mustard on pumpernickel 


Ham with french dressing on white 


Ham with brown mustard on wheat 


Salami with relish on a roll 


Roast beef with yellow mustard on white 


This menu was generated on 2/18/2013 11:37:59 AM 


This is a LisWicy/ Ur\brol It's d lot like i\\t ListBo% 
wW - m it mlievrb i\\t sa^c base dass as 

Usido% } so i*t v^as same item st\tcho^ Wtio^arity. 
Bu-t iA/mdoy/s £*tovc apfs %idally use Listi/iw mstcad 
ListBox. because \i lias move lATmdoy/s S*tovc-likc 
stroWM ar.a U| (taints 从 a 七 make 

vour app look like a Val w ^mdoy/s apf• ^ 

disked or. i\\t -f iyst item -to take i\\\s a^d 

you see 七 rt selects like d l^mdcws £*tovc does. 


Can you build this page on your own just from the screenshot before you see the XAML? 
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bound and determined 


❺ Add object names and data binding to the XAML. 

Here’s the XAML that gets added to MainPage.xaml. Make sure you add it to the outermost grid just above 
the <! - - Back button and page title --> XAML comment, just like you did in the Save the Humans main page. 
We named the button newMenu. Since we used data binding of the ListView, TextBlock, and TextBox, we didn’t 
need to give them names. (Here’s a shortcut. We didn’t even really need to name the button, we did it just to get the IDE to 
automatically add an event handler named newMenu—Click when we double-clicked it in the IDE. Try it out!) 


Hcv-cs 七七 

L'isW'iow Cov\brol 

Tv-v sv/app” 1 七 

OU-t -fOV UstBoX. 

-to see Koy/ i*t 
Aa 呼 s w pay 


heed 

bihdih0 
■to both get ahd 

the hurubcv 
items y/*rth 
/> the TcxtBox. 


<StackPanel Grid.Row= M 1 " Margin='，120,0 n x : Name= n pageLayoutStackPanel M > 

<StackPanel Orientation= M Horizontal" Margin="0,0,0,20"> 

<StackPanel Margin="0,0,20,0 n > 

<TextBlock Style="{StaticResource BodyTextStyle}" 

Text="Number of items" Margin= n 0,0,0,10 n / > 

<TextBox Width="100 n HorizontalAlignment="Left" ^^ 

Text=" {Binding NumberOfItems, Mode=TwoWay } 

</StackPanel> 

〈Button x : Name= M newMenu n VerticalAlignment="Bottom" Click="newMenu_Click 
Content="Make a new menu" Margin= n 0,0,20,0 n /> 

</StackPanel> 

<ListView 工 temsSource= n {Binding Menu}，' Margin= ， '0,0,20,0 n / > 

<TextBlock Style="{StaticResource CaptionTextStyle}"> 

<Run Text="This menu was generated on " / > 

<Run Text=" {Binding GeneratedDate} M /> _ 

</TextBlock> 

</StackPanel> 


This is <Ru^> tajs 

m You da 的 have 

d s'mjlc 7c>c-tBlodk but oY\\y 
b'md pairt o( its 七 


o Add the code-behind for the page to MainPage.xaml.es. 

The page constructor creates the menu collection and the MenuMaker instance, and sets the 
data contexts for the controls that use data binding. It also needs a MenuMaker field called 
menuMaker. 

Youv- mdrn S dlass \v\ 

MenuMaker menuMaker = new MenuMaker () ; %arw | yts a Mcr>uMakcv -field, 

K ^\\\cM is used as i\\t data 

public MainPage() { 

this.InitializeComponent(); 

pageLayoutStackPanel.DataContext = menuMaker; 

} 

You just need to set the data context for the outer StackPanel. It will pass that data context on to all 
of the controls contained inside it. 


^ (or StadkPa^cl i\\ai dorvta’ms 

all *tKc bour^d tov\*tvols. 


Finally, double-click on the button to generate a method stub for its Click event handler. Here’s 
the code for it — it just updates the menu: 

private void newMenu_Click(obj ect sender, RoutedEventArgs e) { 

menuMaker.UpdateMenu(); 

} There’s an easy way to rename an event handler so that it updates XAML 

and C# code at the same time. Flip to leftover #8 in the appendix to 
520 hapter 10 learn more about the refactoring tools in the IDE. 
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Now run your program! Try changing the TextBox to different values. Set it to 3, and 
it generates a menu with three items: 


Welcome to Sloppy Joe's 


Number of items 



Make a new menu 




Did 

the 


Ham with brown mustard on wheat 


Turkey with honey mustard on rye 


Ham with yellow mustard on wheat 


This menu was generated on 2/18/2013 10:29:45 AM 


you \rcnr»crwbc\r -fco update 
sVmg ih the 
<Ragc Rcsou\rdcs> sc^tioh? l-f 
-the XAML (or \i is ih 
st 吓 3 whch you -flip the paje. 


Now you can play with binding to see just how flexible it is. Try entering “xyz” or 
no data at all into the TextBox. Nothing happens! When you enter data into the 
TextBox, you’re giving it a string. The TextBox is pretty smart about what it does 
with that string. It knows that its binding path is NumberOf I terns, so it looks in its 
data context to see if there are any properties with that name, and then does its best 
to convert the string to whatever that property’s type is. 


Keep youv eye oy \ -the 

date. It’s ⑽七 

updatmj, -though -the me 灼 u 

updates, nr»aybc 

still wc v\ccd ho do. 


MY TBXT 

PR^PBRTY^ B^UND TO 
Nmseis^FlTeMS. AND 
MY DATA CO^TBXT HAS A 
NuMae^FlreMS PROPERTY/ 6AN 1 
STICK THIS STRING ' V 3 X, INTO THAT 
PR^PBRTY? LOOKS UKB I 6AMi 






I4MM ； MY 
DATA CONTEXT SAYS 
NuMse^FlTeMS IS AN IMT, 
AND 工 \C^OVJ WOV) JO 

C^NVBRT THB STRING ' V XYZ ；/ JO 
AM IMT. ^UBSS I VJO^T l>0 
AMVTHIN^ AT AUU 
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put your data in context 


Use static resources to declare your objects m XAML 

When you build a page with XAML, you’re creating an object graph with objects like StackPanel, Grid, TextBlock, 
and Button. And you’ve seen that there’s no magic or mystery to any of that — when you add a <TextBox> tag to 
your XAML, then your page object will have a TextBox field with a reference to an instance of TextBox. And if you 
give it a name using the x : Name property, your code-behind G# code can use that name to access the TextBox. 

You can do exactly the same thing to create instances of almost any class and store them as fields in your page by 
adding a static resource to your XAML. And data binding works particularly well with static resources, especially 
when you combine it with the visual designer in the IDE. Let’s go back to your program for Sloppy Joe and move the 
MenuMaker to a static resource. 


O 1>5U5T5 TH5 MeNuMAK 味 FI BUD FEOM TH5 
^D5-B6HIND. 

You’re going to be setting up the MenuMaker class and the data 
context in the XAML, so delete these lines from your G# code: 

Me-rmMa-k-er megmMake-a?-== now MenuMaker () : 

public MainPage () { 

this. 工 nitializeComponent(); 

page Layouts feae-k-PaHe-l-r-DafeaGon text — meivuMakor;_ 


O TAKE A LOOK AT TH5 NAM5SPA65S F^>12 PA^5. 

Look at the top of the XAML code for your page, and you’ll see that the page’s opening tag 
has a set of xml ns properties. Each of these properties defines a namespace. Look for the 
one that starts with xml ns : local and has your project’s namespace. It should look like this: 



Hey, there’s no Close button! How do I 
quit my app? 

Windows Store apps don’t have Close 
buttons by default, because you typically never 
quit most apps. Windows Store apps follow 
an application lifecycle with three states: 
not running, running, and suspended. Apps 
can be suspended if the user switches away 
or Windows enters a low power state. And if 
it needs to reclaim the memory, Windows can 
terminate it. Later in the book you’ll learn how 
to make your app work with this lifecycle. 


This is y(/\Z\L> hdmespdde 
li ^Ohsists o-f 
Vmlhs:” followed by by\ 
idchti-Pic^ ih iW\s cast lodW. 


W\)tY\ -the value s*tav*b with 

i*t v-c-Pcvs *to oy\C *m 

•the fv-ojedt l*t t^Y\ also siav*t with w ivbtf://” 
~ *to vc-Pcv* *to d s*ta^dav*d 


xmlns : local= n using : SloppyJoeChapterlO" 


You’ll use this idc^ii-ficir {jo dveate 
objects \v\ youv 灼 arwespade. 


Since we named our app SloppyJoeChapterl 0, 
the IDE created this namespace for us. Find 
the namespace that corresponds to your app, 
beause that’s where your MenuMaker lives. 
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O ADD TH5 STATIC ISBS^UECB lO Y^>U12 XAML AND S5T TH5 DATA CONTEXT. 

Find the〈Page .Resources〉section of your page and type <local : to pop up an IntelliSense window: 


<Page.Resources 》 


<local ^ 


[H] App 
DID Menu Item 


Meny Maker 


You can only add static resources if their classes 
have parameterless consructors. This makes sense! 
If the constructor has a parameter, how would the 
XAML page know what arguments to pass to it? 


< I-- TODO: De lete this line if the key AppIName is declared in App.xaml.-- > 
<x ^ St ring x : Key = " Ap p Wame 1,1 > We Icome to Sloppy loe 1 s</x : Strings 
</Page.Resources> 


The window shows all of the classes in the namespace that you can use. Choose MenuMaker, and give it the 
name menuMaker: 

<local : MenuMaker x : Name= n menuMaker M / > 

Now your page has a static MenuMaker resource called menuMaker. 


O S5T TH5 DATA CObnBXT F^>12 Y^>U12 STACKPAN5U AND ALU O? ITS 6HILD125N. 

Then go to the outermost StackPanel and set its DataContext property: 

<StackPanel Grid.Row= n 1 n Margin= n 120, 

DataContext= M {StaticResource ResourceKey=memiMaker} n > 

Your program will still work, just like before. But did you notice what happened in the IDE when you added the 
data context to the XAML? As soon as you added it, the IDE created an instance of MenuMaker and used its 
properties to populate all of the controls that were bound to it. You got a menu generated immediately, right 
there in the designer — before you even ran your program. Neat! 



Ham with yellow mustard on wheat 


sorwcthihg s hot \riglvt. H populated 

the \ic^s a^d the mchu, bu-t ho-t 一 

^ 9Chc\ratcd date. IVha-t's gomg oh? 





The shows up \ y \ 

immediately ； 

bc-Po\rc 


you V"uw youv pv-oyam. 


Ham with mayo on white 


Pastrami with french dressing on wheat 


This menu was generated on 
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change your list’s look and feel 

Use a data template to display objects 

When you show items in a list, you’re showing contents of ListViewItem (which you use for ListViews), 
ListBoxItem, or GomboBoxItem controls, which get bound to objects in an ObservableCollection. 
Each ListViewItem in the Sloppy Joe menu generator is bound to a Menu Item object in its Menu collection. 
The ListViewItem objects call the MenuMaker objects’ ToString () methods by default, but you can use 
a data template that uses data binding to display data from the bound object’s properties. 


TKis is a v-cally 
bas'id dd*kd 
tcrwflaic, 9iy\A *i*t 
looks \us*t like 
dc-faul*t oy\c used 
display 


Leave the Lis-t\/icw -taa 

Modify the <Listview> tag to add a basic data template. It , 山此 bd /> with > 
uses the basic {Binding} to call the item’s ToString () - 〆 — add a dosmg </List\/icw> 

a 七 the bottom. Thc^ add 

<ListView 工 temsSource= n {Binding Menu} " Margin= n 0,0,20,0 n > -the Lis-t\/icw.|-tcm7cmpla-tc "tag 
<ListView. ItemTemplate> the data 


<DataTemplate> 

<TextBlock Text= 
</DataTemplate> 
</ListView. 工 temTemplate> 
</ListView> 


{Binding}"/> 


/\dd'm5 d w*i*thou*t 3 

jus 七 dal Is *tv>c ToStv-m^O method o( 
七 he bouy>d objedt 


Change your data template to add some color to your menu. 


<DataTemplate> 
Reflate the <TextBlock> 

<Pata7crwplatc> l < Run Text: 

bu-t leave ihc <Run Text: 

vesi o( 七 he <Run Text: 

Lis*t\/icw </TextBlock> 

</DataTemplate> 


Y 0[a ^ bmd mdividual Run tajs. You dart 

eadh C.oloV"i and O'thcv pvopcirtics -too- 

{Binding Meat}" Foreground= M Blue" / XRun Text= M on "/ > 

{Binding Bread}" FontWeight="Light" / XRun Text= M with "/ > 

{Binding Condiment}" Foreground= M Red" FontWeight= n ExtraBold" / > 


on rye with 


on pumpernickel with 


Go crazy! The data template can contain any controls you want. 


<DataTemplate> 

<StackPanel Orientation 
<StackPanel> 

<TextBlock Text 


'Horizontal M > 


The Data Template objects 
pv-opcirty ohly 
hold oy\c object, so i-f you 
v/ah 七 multiple dohtirols \v\ youv 
data template, you’ll a 
like StatkPa^cl. 


1 {Binding Bread} "/ > 

<TextBlock Text="{Binding Bread} "/ > 

<TextBlock Text="{Binding Bread} "/ > 

</StackPanel> 

〈Ellipse Fi1l= n DarkSlateBlue" Height= M Auto" Width="10" Margin= n 10,0 n /> 
<Button Content="{Binding Condiment}" FontFamily 二 , 'Segoe Script" / > 

</StackPanel> 

</DataTemplate> 
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Dumb Questi9ns 

^^:So I can use a StackPanel or a Grid to lay out my page. 

I can use XAML static resources, or I can use fields in code- 
behind. I can set properties on controls, or I can use data 
binding. Why are there so many ways to do the same things? 

Because C# and XAML are extremely flexible tools for building 
apps. That flexibility makes it possible to design very detailed pages 
that work on many different devices and displays. This gives you 
a very large toolbox that you can use to get your pages just right. 

So don’t look at it as a confusing set of choices; look at it as many 
different options that you can choose from. 

^^,-rm still not clear on how static resources work. What 
happens when I add a tag inside 〈Page • Resources 〉？ 

When you add that tag, it udpates the Page object. Find the 
AppName resource that you changed to set the page header: 

<x : String x:Key= 〃 AppName〃>Welcome to Sloppy 
Joe^s</x : String> 

Now go through the code that the IDE added as part of the Basic 
Page template to find where it uses the resource: 

<TextBlock x : Name= M pageTitle" Grid. 

Column= M 1" 

Text= M {StaticResource AppName} n 

Style="{StaticResource 
PageHeaderTextStyle}"/> 

The page uses this static resource to set the text. So what’s going 
on behind the scenes? You can use the IDE to see what’s going 
on. Put a breakpoint in your button event handler, then run the code 
and press the button. Add this . Resources [ "AppName"] 
to the Watch window, and you’ll see that it contains a reference to 
a string. And every static resource works the same way—when you 
add a static resource to the code, it creates an object and adds it to a 
collection called Resources. 

Can I use that { StaticResource } syntax in my 
own code, or is it just for templates like Blank Page? 

Absolutely, you can set up resources and use them just like 
that. There's nothing special about the Blank Page template, or any 
other templates you'll use in this book. They just use regular XAML 
and C#, and they don’t do anything that you can’t do yourself. 

I used x: Name to set my MenuMaker resource’s 
name, but the AppName resource uses x : Key. What’s the 
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When you use the x : Key property in a static resource, it 
adds the resource to the Resources collection using that key, 
but it doesn’t create a field (so you can’t enter AppName into 
your C# code, you can only access it using the Resources 
collection). When you use the x : Name property, it adds it to the 
Resources collection, but it also adds a field to the Page 
object. That’s how you were able to call the UpdateMenu () 
method on the MenuMaker static resource. 

Does my binding path have to be a string property? 

No, you can bind a property of any type. If it can be converted 
between the source and property types, then the binding will work. 

If not, the data will be ignored. And remember, not all properties 
on your controls are text, either. Let’s say you’ve got a bool in your 
data context called EnableMyObj ect. You can bind it to any 
Boolean property, like I sEnabled. This will enable or disable the 
control based on the value of the EnableMyObj ect property: 

IsEnabled: n {Binding EnableMyObject}" 

Of course, if you bind it to a text property it'll just print True or 
False (which, if you think about it, makes perfect sense). 

Why did the IDE display the data in my form when I added 
the static resource and set the data context in XAML, but not 
when I did it in C#? 

Because the IDE understands your XAML, which has all of the 
information that it needs to create the objects to render your page. As 
soon as you added the MenuMaker resource to your XAML code, 
the IDE created an instance of MenuMaker. But it couldn’t do that 
from the new statement in its constructor, because there could be 
many other statements in the constructor, and they would need to be 
run. The IDE only runs the code-behind C# code when the program 
is executed. But if you add a static resource to the page the IDE will 
create it, just like it creates instances of TextBlock, StackPanel, and 
the other controls on your page. It sets the controls’ properties to 
show them in the designer, so when you set up the data context and 
binding paths, those got set as well, and your menu items showed up 
in the IDE’s designer. 

Tke static resources in your page are 
instantiated wken tke page is first 
loaded and can te used at any time 


difference? 


The w s*ta*tid \rcsouv-dc w is a little mislcadmj. 

S*ta*tid rcsouv-dcs av-c dc-Pmi*tcly dv-catcd -fov cadh 
thcyVc Y\oi s-tatid -Picldsl 


hy tke objects in tke app. 
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ch-ch-ch changes 

INotifyPropGrtyChawgGd lets bound objects send updates 

When the MenuMaker class updates its menu, the ListView that’s bound to it gets updated. But the 
MenuMaker updates the GeneratedDate property at the same time. Why doesn’t the TextBlock that’s 
bound to it get updated too? The reason is that every time an ObservableCollection changes, it fires 
off an event to tell any bound control that its data has changed. This is just like how a Button control 
raises a Click event when it’s clicked, or a Timer raises a Tick event when its interval elapses. Whenever 
you add, remove, or delete items from an ObservableCollection, it raises an event. 

You can make your data objects notify their target properties and bound controls that data has changed, too. 
All you need to do is implement the INoti fyPropertyChanged interface, which contains a single 
event called Proper tyChanged. Just fire off that event whenever a property changes, and watch your 
bound controls update themselves automatically. 


The obje^-t -f iv-cs of-f 
bo 乙 o 的 *brol 

that bound *to a 

property has V 






差: h 








anged event 











1>ATA CONTEXT 





BINDING 




參 





The to 的 *brol \rc^civcs *thc 

v-c-f\rcshcs its tav-yt prope\rty by \rcadm 3 
the da*bd -f\rom *thc sou\r^c pv-opcv-ty -that 

its bou^d *to. 








Collections work almost the same way as data objects. 

Y. r .«• The ObservableCollection<T> object doesn’t actually implement 
W3xCil it! INotifyPropertyChanged. Instead, it implements a closely related 

interface called INotifyCollectionChanged that fires off a 
CollectionChanged event instead of a PropertyChanged event. The control 
knows to look for this event because Observable Collection implements the 
INotifyCollectionChanged interface. Setting a UstView’s DataContext to an 
INotifyCollectionChanged object will cause it to respond to these events. 
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Modify MenuMakerto notify you whew 
the &GwcratGdI?atG property changes 

INotif yPropertyChanged is in the System. ComponentModel 
namespace, so start by adding this using statement to the top of the 
MenuMaker class file: 

using System.ComponentModel; 

Update the MenuMaker class to implement INotif yPropertyChanged, 
and then use the IDE to automatically implement the interface: 

class r'.enui'-'aker : I M.o t i 干 : / Property Changed 

Implement interface 'INotityPropertyChanged' 

Explicitly impletnent interface 'INotifyPropertyChanged' 


This will be a little different than what you saw in Chapters 7 and 8. It won’t add 
any methods or properties. Instead, it will add an event: 


o 


This is the first 
time you’re 
raising events. 

You’ve been 
writing event handler methods since 
Chapter 1, but this is the first time 
you’re firing an event. You’ll learn 
all about how this works and what’s 
going on in Chapter 15. For now, all 
you need to know is that an interface 
can include an event, and that your 
OnPropertyChanged () method 
is following a standard G# pattern for 
raising events to other objects. 



public event PropertyChangedEventHandler PropertyChanged; 


Next, add this OnPropertyChanged () method, which you’ll use to raise the PropertyChanged event. 


private void OnPropertyChanged(string propertyName) { < — 

PropertyChangedEventHandler propertyChangedEvent = PropertyChanged; 
if (propertyChangedEvent != null) { 

propertyChangedEvent(this, new PropertyChangedEventArgs(propertyName)); 


This is a siahdav-d 
MT paU 
\raismj events. 


Now all you need to do to notify a bound control that a property is changed is to call OnPropertyChanged () 
with the name of the property that’s changing. We want the TextBlock that’s bound to GeneratedDate to refresh 
its data every time the menu is updated, so all we need to do is add one line to the end of UpdateMenu () : 


public void UpdateMenu() { 

Menu.Clear(); 

for (int i = 0; i < NumberOfItems; i++) 
Menu.Add(CreateMenuItem()); 

} 



Watch it! 


GeneratedDate = DateTime.Now; 

OnPropertyChanged("GeneratedDate"); 

} 

Now the date should change when you generate a menu. 


Don't forget to implement 

INotifyPropertyChanged- 

Data binding only works when the 
controls implement that interface. 
If you leave •• INotifyPropertyChanged 
out of the class declaration, your bound 
controls won't get updated — even if the data 
object fires PropertyChanged events. 
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go fish goes xaml 



((ciSe 


Finish porting the Go Fish! game to a Windows Store app. You'll need to modify the XAML from earlier 
in this chapter to add data binding, copy all of the classes and enums from the Go Fish! game in 
Chapter 8 (or download them from our website), and update the Player and Game classes. 



Add the existing class files and change their namespace to match your app. 

Add these files to your project from the Chapter 8 Go Fish! code: Values.cs, Suits.cs, Card.cs, Deck.cs, 
CardComparer_bySuit.cs, CardComparer_by Value.cs, Game.cs, and Player.cs. You can use the Add Existing 
Item option in the Solution Explorer, but you’ll need to change the namespace in each of them to 
match your new projects (just like you did with multipart projects earlier in the book). 

Try building your project. You should get errors in Game.cs and Player.cs that look like this: 


The type or namespace name 'Forms' does not ed.:5t in the namespace 'System. Wind owe 1 (are you missing an assembly reference?) 


©2 The type or namespace name 'TextBox 1 could not be found [are you missing a using directive or an assembly reference?) 
Q 3 The type or namespace name TextBox 1 could not be found [are you missing a using directive or an assembly reference?) 



Remove all references to WinForms classes and objects; add using lines to Game. 

You’re not in the WinForms world anymore, so delete using System. Windows . Forms ; from the 
top of Game.cs and Player.cs. You’ll also need to remove all mentions of TextBox. You’ll need to modify 
the Game class to use INotif yPropertyChanged and ObservableCollection<T>, so add 
these using lines to the top of Game.cs: 

using System.ComponentModel; 

using System.Collections.ObjectModel; 



Add an instance of Game as a static resource and set up the data context. 

Modify your XAML to add an instance of Game as a static resource and use it as the data context for 
the grid that contains the Go Fish! page you built earlier in the chapter. Here’s the XAML for the static 
resource: 〈 local: Game x : Name= M game n / > — and you’re going to need a new constructor because 
you can only include resources that have parameterless constructors: 

public Game() { 

PlayerName = "Ed"; 

Hand = new ObservableCollection<string>(); 

ResetGame(); 


o Add public properties to the Game class for data binding. 

Here are the properties you’ll be binding to properties of the controls in the page: 

public bool GamelnProgress { get; private set; } 

public bool GameNotStarted { get { return !GamelnProgress; } } 

public string PlayerName { get; set; } 

public ObservableCollection<string> Hand { get; private set; } 
public string Books { get { return DescribeBooks(); } } 

public string GameProgress { get; private set; } 
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You H v>ccd 


Use binding to enable or disable the Text Box, ListBox, and Buttons. 

You want the “Your Name’’ TextBox and the “Start the game!” Button to be enabled only when 
the game is not started, and you want the “Your hand” ListBox and “Ask for a card’’ Button 
to be enabled only when the game is in progress. You’ll add code to the Game class to set the 
GamelnProgress property. Have a look at the GameNotStarted property. Figure out how 
it works, then add the following property bindings to the TextBox, ListBox, and two Buttons: 

工 sEnabled= n {Binding GamelnProgress} n 工 sEnabled= n {Binding GameNotStarted} 

工 sEnabled= n {Binding GamelnProgress}" 工 sEnabled= n {Binding GameNotStarted} 


o 

© 


Modify the Player class so it tells the Game to display the game’s progress. 

The WinForms version of the Player class takes a TextBox as a parameter for its constructor. 

Change that to take a reference to the Game class and store it in a private field. (Look at the 
S t art Game () method below to see how this new constructor is used when adding players.) 

Find the lines that use the TextBox reference and replace them with calls to the Game object’s 
AddProgress () method. 

Modify the Game class. 

Change the PlayOneRound () method so that it’s void instead of returning a Boolean, and have it use 
the AddProgress () method instead of the TextBox to display progress. If a player won, display that 
progress, reset the game, and return. Otherwise, refresh the Hand collection and describe the hands. 

You’ll also need to add/update these four methods, and figure out what they do and how they work. 


public void StartGame() { 

ClearProgress (); 

GamelnProgress = true; 

OnPropertyChanged("GamelnProgress"); 
OnPropertyChanged("GameNotStarted"); 

Random random = new Random(); 
players = new List<Player>(); 
players.Add(new Player(PlayerName, random ； 


public void AddProgress(string progress) 

{ 

GameProgress = progress + 

Environment.NewLine + 
GameProgress; 

OnPropertyChanged("GameProgress"); 

} 

this)); 


random, this)); 
random, this)); 


players.Add(new Player("Bob" 
players.Add(new Player("Joe" 

Deal (); 

players[0].SortHand(); 

Hand.Clear (); 

foreach (String cardName in GetPlayerCardNames() 
Hand.Add(cardName); 
if (!GamelnProgress) 

AddProgress(DescribePlayerHands()); 


You’ll also need to implement the 
INotifyPropertyChanged 
interface and add the same 
OnPropertyChanged () method 
that you used in the MenuMaker class. 
The updated methods use it, and your 
modified PullOutBooks () method 
will also use it. 


OnPropertyChanged("Books"); 


public void ClearProgress() { 

GameProgress = String.Empty; 
OnPropertyChanged("GameProgress"); 


public void ResetGame() { 

GamelnProgress = false; 

OnPropertyChanged("GamelnProgress n ); 
OnPropertyChanged("GameNotStarted"); 
books = new Dictionary<Values, Player>(); 
stock = new Deck(); 

Hand.Clear(); 
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exercise solution 


Here’s all of the code-behind that you had to write: 

private void startButton—Click(object sender, RoutedEventArgs e) { 

game.StartGame(); 

} 

private void askForACard—Click(object sender, RoutedEventArgs e) { 

if (cards.Selectedlndex >= 0) 

game.PlayOneRound(cards.Selectedlndex); 

} 

private void cards_DoubleTapped(object sender, DoubleTappedRoutedEventArgs e) { 

if (cards.Selectedlndex >= 0) 

game.PlayOneRound(cards.Selectedlndex); 

} 

These are the changes needed for the Player class: 

class Player { 

private string name; 

public string Name { get { return name; } } 

private Random random; 
private Deck cards; 

private Game game; 

public Player(String name. Random random. Game game) { 
this.name = name; 
this.random = random; 

this•game = game; 

this.cards = new Deck(new Card[] { }); 

game.AddProgress(name + " has just joined the game"); 

} 

public Deck DoYouHaveAny(Values value) 

{ 

Deck cardsIHave = cards.PullOutValues(value); 

game .AddProgress (Name + " has " + cardsIHave. Count + ’▼ '▼ + Card. Plural (value)); 

return cardsIHave; 

} 

public void AskForACard(List<Player> players, int mylndex. Deck stock. Values value) { 

game .AddProgress (Name + ’▼ asks if anyone has a M + value); 

int totalCardsGiven = 0; 

for (int i = 0; i < players.Count; i++) { 

if (i != mylndex) { 

Player player = players[i]; 

Deck CardsGiven = player.DoYouHaveAny(value); 
totalCardsGiven += CardsGiven.Count; 
while (CardsGiven.Count > 0) 

cards.Add(CardsGiven.Deal()); 

} 

} 

if (totalCardsGiven == 0) { 

game. AddProgress (Name + '▼ must draw from the stock. M ); 

cards.Add(stock.Deal()); 


// ... the rest of the Player class is the same ••• 


E«ef(ciS< 


内 购鉍 
§OL;utipH 
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These are the changes needed for the XAML: 


<Grid Grid.Row= M l" Margin:' ， 120 , 0 , 60 , 60 n DataContext= n {StaticResource ResourceKey=game} 

<TextBlock Text= M Your Name" Margin= ， ' 0 , 0 , 0 , 20 ，' 


> 


\ Thc data -Pov- the yid is 七 he 

今 arwe dlass, s'mdc dll o( -the is 

"to piropcirtics ot\ that dass. 


/> 


Style= M {StaticResource SubheaderTextStyle}"/> 

<StackPanel Orientation="Horizontal" Grid.Row= M 1"> 

The UBo* <TextBox x : Name= M playerName n FontSize="24" Width="500" MinWidth="300" 

has a two - 一 > Text= n {Binding PlayerName, Mode=TwoWay} M IsEnabled= n {Binding GameNotStartedl n 

y/3y bmdm^ *to 〈Button x : Name=" startButton" Margin="20 f 0" IsEnabled= n { Bindin g GameNot Star ted} 
Playcv-N^^C- Content= M Start the game!，’ Click= n startButton—Click” /> ^ 

</StackPanel> ttcvc^s C\\C^ ii3^dlcv 

〈TextBlock Text="Game progress" -fov 

Style= M {StaticResource SubheaderTextStyle}" Margin= n 0,20,0,20 n Grid.Row="2 

<ScrollViewer Grid.Row= M 3" FontSize 二 n 24 n Background="White" Foreground="Black" 

Content: n {Binding GameProgress} M /> ^ - 

<TextBlock Text="Books" Style="{StaticResource SubheaderTextStyle} 

Margin= n 0,2 0,0,20" Grid.Row= M 4"/> 

<ScrollViewer FontSize= M 24" Background= M White" Foreground="Black" 

Grid.Row= n 5" Grid.RowSpan="2" Content: n {Binding Books}" / > 

<TextBlock Text="Your hand" Style="{StaticResource SubheaderTextStyle}" 

Grid.Row="0" Grid.Column= M 2" Margin= n 0,0,0,20 n /> 

<ListBox Background="White" FontSize="24" Height= M Auto" Margin= n 0,0,0,20 
x : Name= M cards" Grid.Row="1" Grid.RowSpan= M 5" Grid.Column= M 2" 

IternsSource= n {Binding Hand} n IsEnabled= M {Binding GameInProgress} 


/> 


The Pv-ojvcss a^dl 
Books S£.\roll\/icy/cV"S 
b*md bo 七 he Pirogvcss 
Books pvopcirtics. 


DoubleTapped= n cards_DoubleTapped n /> 

〈Button x : Name= M askForACard M Content= M Ask for a card" HorizontalAlignment 1 
VerticalAlignment= M Stretch" Grid.Row=" 6 " Grid.Column=" 2 " 

Click= M askForACard__Click M IsEnabled="{Binding GamelnProgress} M /> 

<Grid.ColumnDefinitions> 


Stretch' 


n 5 *"/> 
" 40 "/> 
，，2*"/> 


<ColumnDefinition Width= 

<ColumnDefinition Width= 

<ColumnDefinition Width= 

</Grid.ColumnDefinitions> 

<Grid.RowDefinitions> 

<RowDefinition Height= M Auto" / > 

<RowDefinition Height= M Auto" / > 

<RowDefinition Height= M Auto" / > 

<RowDefinition/> 

<RowDefinition Height= M Auto" / > 

<RowDefinition Height= M Auto" MinHeight="150 
<RowDefinition Height= M Auto" / > 

</Grid.RowDefinitions> 

</Grid> 


The IsE^abled pv-opev-ty enables 
o\r disables It’s a 

Poolca 灼 pv-opc\rty, so you da 灼 

bmd i*t *to a Booled^ p\ropc\rty 

b> *bu\r 灼 or\ ov okk 

based oy\ that pv-opev-ty. 


/> 
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exercise solution 



Here’s everything that changed in the Game class, including the code we gave you with the instructions. 




using System.ComponentModel; 

using System.Collections.ObjectModel; 


Y® u these I'mes -fov- 

I ^ oti-fyP\ropc\rtyChahgcd 

Obsc\rvablcCollct-tioh. 


These p\rofcv-*tics art 

used by the )<AML- 
dd'kd 


class Game : 工 NotifyPropertyChanged { 
private List<Player> players; 
private Dictionary<Values, Player> books; 
private Deck stock; 

public bool GameInProgress { get; private set; } 
public bool GameNotStarted { get { return !GameInProgress; } } 

public string PlayerName { get; set; } 

public ObservableCollection<string> Hand { get; private set; } 
public string Books { get { return DescribeBooks(); } } 
public string GameProgress { get; private set; 


These methods 
mdke 七 he 
process data 
y/ovk. 
New Irncs a\rc 
Bddtd b> the 

•top so 
old ad*tivi*ty 
sdv-olls o-f-f 
bottom o-f 七 he 
Sd\roll\/icy/c\r. 


public Game() { 

PlayerName = "Ed"; 

Hand = new ObservableCollection<string>() 
ResetGame(); 


the dohS-t\rud"tov. 

Wlc ov\\y dveate ov\t dollcdiioK> a^d 
jus-t dear rt 七 he is 

v-cset l-f wc dveated a objed-t, 
-Povrw would lose its \rc-Pcv-cr>dc 
■fco rt, artdi the updates would s-top. 


public void AddProgress(string progress) { 

GameProgress = progress + Environment.NewLine + GameProgress 
OnPropertyChanged("GameProgress"); 


public void ClearProgress() { 

GameProgress = String.Empty; 
OnPropertyChanged("GameProgress"); 


-the 

S*ta\rt^amcO method 
-that wc javc you. It 
dlcav-s -the pv-oyess, 
dv-ca*tcs the flayev-s, 
deals -the dav-ds, a^d 
updates the 
p\ro^\rcss books. 


public void StartGame() { 

ClearProgress(); 

GameInProgress = true; 

OnPropertyChanged("GamelnProgress"); 
OnPropertyChanged("GameNotStarted"); 

Random random = new Random (); 
players = new List<Player>(); 

players.Add(new Player(PlayerName, random, this)) 
players.Add(new Player("Bob", random, this)); 
players.Add(new Player("Joe", random, this)); 

Deal(); 

players[0].SortHand(); 

Hand.Clear(); 

foreach (String cardName in GetPlayerCardNames()) 
Hand.Add(cardName); 
if (!GamelnProgress) 

AddProgress(DescribePlayerHands()); 
OnPropertyChanged("Books"); 


Every program you’ve written in 
the book so far can be adapted or 
rewritten as a Windows Store app 
using XAML. But there are so many 
ways to write them, and that’s 
especially true when you’re using 
XAML! That’s why we gave you so 
much of the code for this exercise. 
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^ This used -to v-c*tuv-^ a Boolean value so the -Pov-m dould upda-tc its pv-o^v-css. Nov/ i*t 
\us*t ^eeds -to ta\\ Add?royrtss, a^d data b'md'mj will take dav-c o( the updatmj -fov 

public void PlayOneRound(int selectedPlayerCard) { 

Values cardToAskFor = players[0].Peek(selectedPlayerCard).Value; 
for (int i = 0; i < players.Count; i++) { 

if (i == 0) 

players[0].AskForACard(players, 0, stock, cardToAskFor); 

else 

players[i]•AskForACard(players, i, stock); 
if (PullOutBooks(players[i] ) ) { 

AddProgress (players [i] .Name + ’▼ drew a new hand"); 

int card = 1; 

while (card <= 5 && stock.Count > 0) { 

players[i].TakeCard(stock.Deal()); 
card++; 


us. 



The books 乩 ahd the 
heeds -to khow about the dhahae 
it W irc-flrcsh \is 


OnPropertyChanged("Books"); 

players[0].SortHand(); 
if (stock.Count == 0) { 

AddProgress("The stock is out of cards. Game over! n ) 
AddProgress ("The winner is . . . '▼ + GetWinnerName ()); 
ResetGame(); 
return; 


so 




Hand.Clear(); 

foreach (String cardName in GetPlayerCardNames()) 
Hand.Add(cardName); 
if (!GamelnProgress) 

AddProgress(DescribePlayerHands()); 


mod»-f »^ 3 *tior\s *to 

•bhe Play 0 r\cRour\di 0 method 七 ha 七 

is over, or ufda*tc 
3r\d books i-f r\o*t- 


This is -the Rcsci^amcO meihod 
-Pv-orn the ms-tvudtio^s. H deavs 
the books, s-todk, a^d hand. 


public void ResetGame() { 

GamelnProgress = false; 

OnPropertyChanged("GamelnProgress"); 

OnPropertyChanged("GameNotStarted"); 
books = new Dictionary<Values, Player>(); 
stock = new Deck(); 

Hand.Clear(); 

} This is 七 he standard 

/ P\ropcv-iyChar>jcd ever\i 

public event PropertyChangedEventHandler PropertyChanged; -fvorw cav-|icv- *m 

private void OnPropertyChanged (string propertyName) { 七 he ^hap-tev-. 

Prope r tyChangedEven tHandle r propertyChangedEvent = PropertyChanged; 
if (propertyChangedEvent != null) { 

propertyChangedEvent(this, new PropertyChangedEventArgs(propertyName)); 


// 


參 • • 


the rest of the Game class is the same 
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async ， 这 w^it ， 肋 d cfe 位 contr sori^izstiovi 


Pardon the interruption + 



MY ^ATeUAt>yAs ync() 
METHOD U6TS MB FIMISH 
MY R^MANTI^ DATB WITH 
MAR^ARBT WITHOUT KBBPIN^ 
SUZIB WAITIM^. 


Nobody likes to be kept waiting...especially not users. 

Computers are good at doing lots of things at once, so there’s no reason your 
apps shouldn’t be able to as well. In this chapter, you’ll learn how to keep your 
apps responsive by building asynchronous methods. You’ll also learn how 
to use the built-in file pickers and message dialogs and asynchronous 
file input and output without freezing up your apps. Combine this with data 
contract serialization, and you’ve got the makings of a thoroughly modern app. 


this is a new chapter 













where’d they go? 


Priaw runs into file trouble 

Brian’s got his XAML, he’s got his data binding, and he’s all ready to 
start porting his Excuse Manager to a Windows Store app. Everything’s 
going great, until... 



System.10- 

Bin ary Reader 
EinaryWriter 
n Compression 
% EndOfStreamException 
FIleNotFoundException 
I nva I i d Data Exc epti on j 

々 10Exception Yep, File dass h 饮 e. 

MemoryStream k ， 

Path 
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async await and data contract serialization 


AMD 工 FIND MY 

BIMARYF^RMATTBR, BITHBR. 
VOHAT l>0 I USB TO SBRIAUIZB 
MY 


System.Runtime. Seria II zat ion 


TW»S looks ^vow'ism^, 4。斗 


b 



% 

% 


Coll ecti on Data Co ntra ctAttrib ute 


▲ 


Contra ctNam espac eAttrib ute 
D ata Contra ctAttrib ute 
D ata Contra etRes-olver 
Data Co ntra ctSerial izer 
D ata Co ntra ctSerial izerSetti ngs 
Data Memb erAttribute 
DateTImeFormat 
Enn itTypelnformation 


▼ 



VOIMD^WS ST^RB APPS 
IMPR^>VBD ON A U>J O? WHAT 
VO INFORMS ^AVB MB. I BBT THBR5 
ARB S^MB &OOX> TOOUS … AND A 
&OOX> RBAS^N THBS5 THINGS ARB 
MISSING. 


Windows Store apps have superior I/O tools. 

When you build a Windows Store app, it needs to be 
responsive, intuitive, and consistent. That’s why the .NET 
Framework for Windows Store Apps includes classes and 
methods that let you display file dialogs and do file I/O 
asynchronously — which means they don’t lock up your app 
while dialogs are displayed or files are written. And by using 
data contracts for serialization, your apps can write files 


that are easier to work with, and much clearer to understand. 


you see 3iv\ 
hou\rgl«lss, that 
youVc 

usihg a p\rogv-arw 
that’s locked uf 

dhd lids become 


Uhvcspohsivc-clhd 
usc\rs hale tha-t/ 
(Doh’t you?) 


you are here ► 


537 












don’t keep me waiting 


Windows Store apps use await to be more responsive 


What happens when you call MessageBox . Show () from a WinForms program? Everything 
stops, and your program freezes until the dialog disappears. That’s literally the most unresponsive 
that a program can be! Windows Store apps should always be responsive, even when they’re waiting 
for feedback from a user. But some things — like waiting for a dialog, or reading or writing all the 
bytes in a file — take a long time. When a method sits there and makes the rest of the program wait 
for it to complete, programmers call that blocking, and it’s one of the biggest causes of program 
unresponsiveness. 


Windows Store apps use the await operator and the async modifier to keep from becoming 
unresponsive during operations that block. You can see how it works by looking at how Windows 
Apps pop up dialogs without blocking the app by using the Me s sage Dialog class: 

Co^-fiju\rc ihc McssagcDialog 

You ercait a McssajcPialo^ by jiving i-t a message av\d 

objedt -the same way -that youd add’n^ 代 spemses. Eadh vcspo^sc 

any othev dlass. is a UlComms^d object 


4 


MessageDialog dialog = new MessageDialog("Message" 
dialog. Commands .Add (new UlCommand ("Response # 1 ff )); 
dialog.Commands.Add(new UlCommand("Response 
dialog.Commands.Add(new UlCommand("Response 
dialog.DefaultCommandlndex = 


) 


# 2 ”）) 
#3”）） 



UlCommand result = await. 



dialog.ShowAsync() 


as UlCommand/ 


The await operator causes the method that’s running this code to stop and wait until the 
ShowAsync () method completes — and that method will block until the user chooses one of the 
commands. In the meantime, the rest of the program will keep responding to other events. As soon 
as the ShowAsync () method returns, the method that called it will pick up where it left off (although it 
may wait until after any other events that started up in the meantime have finished). 


If your method uses the await operator, then it must be declared with the async modifier: 


public async void ShowADialog() { 

// •… some code •… 

UlCommand result = await dialog.ShowAsync() as UlCommand/ 
/ / •… some more code : 


When a method is declared with async, you have some options with how you call it. You can call 
the method as usual. When you do, as soon as it hits the await statement it returns, which keeps the 
blocking call from freezing your app. 
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You can see exactly how this works by creating a new Blank App and adding the following XAML: 


<StackPanel VerticalAlignment="Top n HorizontalAlignment="Center"> 

<Button Click= M Button_Click_l M FontSize="36">Are you happy?</Button> 
<TextBlock x : Name="response" FontSize="36"/> 

<TextBlock x : Name="ticker" FontSize= M 36"/> 

</StackPanel> 



Here’s the code-behind. You’ll need to add using Windows . UI • Popups ; because MessageDialog and 
UI Command are in that namespace. 


DispatcherTimer timer = new DispatcherTimer(); 

private void Button_Click_l(object sender, RoutedEventArgs e) { 
timer.Tick += timer—Tick; 

timer • 工 nterval = TimeSpan.FromMilliseconds(50); 


int 


timer.Start(); 
CheckHappiness(); 

i = 0; 


T\ry movrnj ihc |*mc hcvc- The will 

s^top ir^edia 七 ely, because -the asyw mcihod 

\rc*tu\r^s as sooh as *rt hits -the dY/a'rt opev-a-fcov-. 


void timer^Tick(object sender, object e) { 
ticker.Text = "Tick + i++; 


private async void CheckHappiness() { 

MessageDialog dialog = new MessageDialog ("Are you happy ?’'）； 
dialog.Commands.Add(new UlCommand("Happy as a clam!")); 
dialog.Commands.Add(new UlCommand( n Sad as a donkey ."))； 
dialog•DefaultCommandlndex = 1; 

UlCommand result = await dialog.ShowAsync() as UlCommand; 
if (result != null && result.Label == "Happy as a clam!") 
response.Text = "The user is happy"; 

else 

response.Text = "The user is sad"; 
timer.Stop(); 


When you run the program, you can see the timer ticking while the dialog is open. Your app remains responsive! It 
doesn’t stop ticking until after you click on one of the dialog options, at which point the method resumes. 


Are you happy? 
Tick #141 


Are you happy? 


Happy as a clam! 


Sad as a donkey. 
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pick a file, any file 

Use the FilelO class to read and write files 

WinForms use the System. 10 . File class to read and write files, but you’ve already seen that class doesn’t exist 
in the .NET Framework for Windows Store apps. And that’s a good thing! If you use File . WriteAllText () 
to write a giant file that will fill up a big portion of your hard drive, it will block and cause your program to 
become unresponsive. 

Windows Store apps can use Windows . Storage classes to read and write files. That namespace includes 
a class called FilelO, which has some familiar-looking methods that pop up in its IntelliSense window. 

FilelO. 

© Append LinesAsync 
© AppendTextA&ync 
© Equals 

© Read Buff erA&ync 
© ReadLin esAsync 
© ReadTectA&ync 
© ReferenceEquals 
© WriteBufferAsync 
© Wri teByt esAsy nc 


These methods look similar to the 
ones in the File class. The FilelO 
class has AppendLinesAsync () 
and ReadTextAsync (), where the 
File class had AppendLines () 
and ReadText (). The difference 
is that each of these methods is 
declared using the async modifier, 
and uses the await operator to do 
the actual file reading. That lets you 
write code that can read and write 
files without blocking. 


Use the file pickers to locate file paths 

MessageBoxes aren’t the only kinds of dialogs that cause your WinForms programs 
to become unresponsive. File dialogs do exactly the same thing. Windows Store apps 
have their own file pickers to access files and folders, and they’re asynchronous, too 
(so they don’t block). Here’s how to create and use a FileOpenPicker to find a file 

to open, and ReadTextAsync () to read the text from it into a file: y^ u doh-fijuv-c the oy\ 

"the pidkcv- usihj By\ object 

This FilcOpc^Pidkcv is C-o^-fijuircd "to 

FileOpenPicker picker = new FileOpenPicker { 〆/ display 仑 | cs as a 味 —start .m 七 he 
ViewMode = PickerViewMode . List, usev-^s dodur>r»c^-b libvav-y -Poldcv. 

SuggestedStartLocation = PickerLocationld•DocumentsLibrary 

} f This has a dollcd*tior> tailed FilcTyfcPil*tcv* 

picker . FileTypeFilter . Add ( n • txt▼▼) ; Kas -the -types o-f -files i*t load. 

工 StorageFile file = await picker.PickSingleFileAsync(); 

null) { 

await FilelO.ReadTextAsync(file); 

/ 


if (file != 

string fileContents 


Ditkcv- v-c*tuv-ir\s 

y/Kc^ you a srn^lc ^lc. Vou II ^rcad a 
lo 七 move abou 七 I 七 … a k ? a 3 cs * 


You da 灼 pass *thc IS-tov-a^cFilc 

s-tv-aigivt *m*to Filc |0 RcadTc%*tAsy^O 
-to read -Pile- 
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rtcvc S y/Ka-t -tKc ?y\tO^?\tVtr 
looks like rb’s o\>ey\. 



FileS v Libraries 


Go up Sort by name ^ 


Documents 


Music 


Pictures 


Videos 



Open Cancel 


The FileSavePicker lets the user pick a file to save. Here’s how it can 
be used in conjunction with FilelO • WriteTextAsync () to write text 
to a file: 

FileSavePicker picker = new FileSavePicker { 

DefaultFileExtension = n .txt n , 

SuggestedStartLocation = PickerLocationld•DocumentsLibrary 


The FilcSavcPidkcv vetuv-^s ay\ (S-tovajcFilc, 
"too. I 七 dohtarns all o*f 七 he 'm-Po\rnr»a-tio^ 
needed -to v-cad o\r y/vi-tc -to b -filci a^d 乙扣 

be passed stvaijht io WriicTc^i^syuO. 


picker.FileTypeChoices.Add("Text File ", new List<string>() { n .txt ▼’ 

picker.FileTypeChoices.Add( M Log File ", 

new List<string> () { n . log" , n .dat ▼’ }); 

工 StorageFile saveFile = await picker.PickSaveFileAsync(); 
if (saveFile == null) return; 

await FilelO.WriteTextAsync(saveFile, textToWrite); 



Files v Libraries 

Go up Sort by name v 


File name 
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raise the bar for your app 


Puild a slightly less simple text editor 

Let’s rebuild the Simple Text Editor from Chapter 9 as a Windows Store app. You’ll use the 
FilelO class, a FileOpenPicker, and a FileSavePicker to load and save the files. 
But first you’ll build the main page. And since this is a Windows Store app that can open and 
save files, it should have an app bar with Open and Save buttons, so you’ll use the IDE 
to add one. 



An AppBar control is a lot like a ScrollViewer or Border, because it can contain another 
control. It knows how to hide and show itself, and acts just like any other app bar. All you 
need to do is add it to the <BottomAppBar> or <TopAppBar> section of a page. 



Create a new Windows Store Blank App project, and replace MainPage.xaml with a new Basic Page. 
Here’s XAML for the page contents: 


<Grid Grid.Row=" 1 " Margin= ， ' 120 , 0 , 60 , 60 n > 
<Grid.RowDefinitions> 

<RowDefinition Height= n Auto" / > 
<RowDefinition/> 

<RowDefinition Height= n Auto" / > 

</Grid.RowDefinitions> 


<TextBlock x : Name="filename" Margin= n 10 " Style="{StaticResource TitleTextStyle} M > 


Untitled 

</TextBlock> 

〈Border Margin= n 10 " Grid.Row= M 1 "> 


The property makes 

the UBo 乂 multilmc mfut 


<TextBox x : Name= M text" AcceptsReturn= M True" 

ScrollViewer.VerticalScrollBarVisibility="Visible" 
ScrollViewer.HorizontalScrollBarVisibility="Visible 
TextChanged="text_TextChanged M / > 



The Tc>^*tBox. doirrbrol dd 灼 

display hov-izo^-tal 
vcv-tidal sd\rollbav-s. These 
pvopc\rtics *tu\nr\ oy \- 


</Border> 


</Grid> 


Right-click on text—TextChanged and choose Navigate to Event ： Handler from the menu. The IDE 
will create the Text Changed event handler for your TextBox. 


❺ 


Use the Document Outline to select the Page (or select any control and press Escape a few times). Go 
to the Properties window, expand the Common section, and find the BottomAppBar property: 


di Common 
Bottom App Bar 


New □ 


Click the New button to add a bottom app bar. The IDE will add this code to your page: 

<common : LayoutAwarePage.BottomAppBar> 

<AppBar/> 

</common : LayoutAwarePage.BottomAppBar> 
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❺ Replace <AppBar/> in the XAML editor. Use a <StackPanel> that contains Open and Save buttons: 

<common : LayoutAwarePage.BottomAppBar> 

<AppBar x : Name="bottomAppBar" Padding= n 10,0,10,0，'> 

<StackPanel Orientation="Horizontal" HorizontalAlignment="Right"> 

<Button x : Name="openButton M Click= n openButton—Click ’， 

Style="{StaticResource OpenFileAppBarButtonStyle}"/> 

〈Button x : Name=" saveButton" 工 sEnabled= n f alse n V® u 11 s< \uijgly blue 

Click="saveButton_Click M Irncs uhdev -these s-tylcs 

Style=" { StaticResource SaveAppBarButtonStyle } " /> uh*ti| you 'them 

</StackPanel> m StandavdSt/lesoca 

</AppBar> 

</common : LayoutAwarePage.BottomAppBar> 



Uh oh — the two static resources, OpenFileAppBarButtonStyle and SaveAppBarButtonStyle, don’t seem to 
be there! That’s OK. The Blank App template comes with a file called StandardStyles.xaml ~you can see 
it if you expand the Common section in the Solution Explorer. Most of that file is commented out, but you can 
uncomment any style that you want to use. 


Choose Edit^Find and Replace^Quick Find from the menu and find OpenFileAppBarButtonStyle: 


^ OpenFileAppBarButtonStyle 
Aa AU Entire Solution 





^akc suve you scav-^h 
the Ch*ti\rc solution. 


Keep pressing the ^ button, and eventually you’ll find a <Style> tag in StandardStyles.xaml: 

〈Style x:Key="OpenFileAppBarButtonStyle" TargetType="ButtonBase" BasedOn="{StaticResource AppBarButtonStyle}"> 
〈Setter Property="AutomationProperties.Automationld" Value="OpenFileAppBarButton"/> 

〈Setter Propenty="AutomationPropenties.Name" Value="Open File "/〉 

〈Setter Property="Content" Value="&#xElA5; "/> 

〈 /Style 〉 

Add --> and < ! -- to uncomment the style, which are how you end and begin comments in XML: 

--> 

<StyIe x: Key: "OpenFlieAppEarButtonStyle 1F TargetType = " ButtonBase 1 " BasedOn= 1, {StaticResource AppBarButtonStyle} 1p > 
<Setter P roperty= ''Automat ionPrope rt ies. Automat ionld lp Value = 1f Op enF ileAp pBarB utto n'V> 

< Setter P ro pe rty = lp Auto mat io n P ro p e rt i e s. N ame " Value =l, Open Fiie 1, /> 

<5etter Prop.erty =■’.Content 1 ’ ValLiie = lp &#xElA5; 1( /> 

</Style> 

< ■! — 


Then do the same thing for SaveAppBarButtonStyle. Search for it and uncomment it. 

Finally, select the <AppBar> tag in the XAML window. This causes the app bar to be displayed in the designer. 



Show -the app bair m the 
^ dcsi^cv by sclcdtmg its 
XAML Code, -tlich double- 
didk oy \ eddh bu'ttoh ■fco 

add a Clidk lid^dlev*. 
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your editor’s looking pretty good 



Here’s the code-behind for the entire program. It uses the TextBox . Text property 
to modify the text in the textbox. We’re modifying a property on the object instead of 
using data binding in order to keep the code in this program as similar as possible to the 
Simple Text Editor in Chapter 9. That will give you a reference point for comparison 


if you want to flip back and forth to see how things change between WinForms and 
Windows Store apps. You’ll also need these using statements at the top of the file: 

using Windows.System; 
using Windows.Storage; 
using Windows.Storage.Pickers; 
using Windows•UI•Popups; 

Here’s the rest of the code. It should all go into the MainPage class. 


Rebuilding a 
program you've 
already built 
using a new 
technology is a 
great way to get 
that new material 
into your brain. 


When you 
have an 
await 
in your 
method, 
you must 
have an 
async 
in the 
method’s 
declaration. 


bool textChanged = false; 
bool loading = false; 

工 StorageFile saveFile = null; 


You II Y\ttd these *th\rcc -fields. The boolean av-c used 
-to add the ^ "to the o-P -the -filename. The 
iS-tov-a^cFilc keeps *tv-a^k of -the -file bemj saved so 
it dots^i have -to keef display'mj iiic save -Pile 


private async void openButton_Click(object sender, RoutedEventArgs e) { 
if (textChanged) { 

MessageDialog overwriteDialog = new MessageDialog( 


"You have unsaved changes. Are you sure you want to load a new file ?’，）； 
overwriteDialog. Commands . Add (new UICommand( ， 'Yes n )); 
overwriteDialog.Commands.Add(new UICommand( n No n )); 
overwriteDialog•DefaultCommandlndex = 1; 

UlCommand result = await overwriteDialog.ShowAsync() as UlCommand; 


if (result != null && result.Label == "No") 


return; 

} 

OpenFile(); 


TV^c buttew displays a dialog i-f av-c 
\ ^saved usev it ta\\s 

0^\\t0 bo display a 以 kev ad of ⑼ hie. 


The Save 


private void saveButton_Click(object 
vc - 一 ^ SaveFile (); 

bu*ttoh just } 

匕 alls the 

SavcFilcO private void text_TextChanged(obj ect 

method. if (loading) { 

loading = false; 
return; 

} 

if (!textChanged) { 

filename.Text += n *"; 
saveButton • 工 sEnabled = true 
textChanged = true; 


sender, RoutedEventArgs e) 


sender, TextChangedEventArgs e) { 

Oy\Ct the "text 匕 a 决 should be ddded 
"to "the tv\& o-P "tlic 一 bu*t should ov\\y 

be sdded ov\Ct- The "textChanged -field keeps 

i-P the icxi has 

c r 

The loadmg -field keeps it -fvom addmj that 
來 i^^cdia-tcly a-ftev- its loaded (because the 

fihahjes, whi^h tv-igjcv-s the cvcht). See i-f 

you t^y\ -f igu\rc out how i*t wovks. 
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private async void OpenFile () { 

FileOpenPicker picker = new FileOpenPicker { 

ViewMode = PickerViewMode•List, 

SuggestedStartLocation = PickerLocationld•DocumentsLibrary 

}； 

picker.FileTypeFilter.Add(".txt"); 
picker.FileTypeFilter.Add(".xml"); 
picker.FileTypeFilter.Add(".xaml"); 

工 StorageFile file = await picker.PickSingleFileAsync(); 
if (file != null) { 

string fileContents = await FilelO•ReadTextAsync(file); 
loading = true; 
text.Text = fileContents; 
textChanged = false; 
filename.Text = file.Name; 
saveFile = file; 


private async void SaveFile () { 

if (saveFile == null) { 

FileSavePicker picker = new FileSavePicker { 

DefaultFileExtension = ".txt ", 

SuggestedStartLocation = PickerLocationld•DocumentsLibrary 

}； 

picker . FileTypeChoices . Add ( "Text File，'，new List<string> () { " . txt" }); 

picker.FileTypeChoices.Add("XML File", new List<string>() { ".xml ", ".xaml" }); 

saveFile = await picker.PickSaveFileAsync(); 
if (saveFile == null) return; 

} 

await FilelO•WriteTextAsync(saveFile, text.Text); 
await new MessageDialog("Wrote " + saveFile.Name).ShowAsync(); 

textChanged = false; 
filename.Text = saveFile.Name; 


You can hold the 
Windows key and 
press Z to show 
the app bar for 
the current app. 


The ar\d SavcFilcO methods art 

\rcally similar *to tode OY\ the f\rcvious 

pay. They display the fidkev-, use -the 
File|0 methods *to load ov save -the -Pile. 



You’re all done. Fire it up! 


Simple Text Editor 

emailToCaptainAmazing.txt 


To: CaptaioAmazing@objectville.net 
From: Commissioner@objectiville.net 
Subject Can you save the day … again? 

We've discovered the Swindlers plan: 

The plan -> How I II defeat Captain Amazing 

The plan -> Another genius secret plan by The Swindler 

The plan •> I’ll create an army of clones arvd unleash them upon the citizens of Objectville. 
The plan -> Clone #0 attacks the mall 
The plan -> Clone #1 attacks downtown 
The plan -> Clone #2 attacks the mall 
The plan -> Clone #3 attacks downtown 
The plan -> Clone #4 attacks the mall 
The plan -> Clone #5 attacks downtown 
The plan -> Clone #6 attacks the mall 

Can you help us? 


>u bvmg up -the bav 
by oy 仏⑶ 

dv-ajjmj up -Pvom -the boi-tom o( 
the You also use 
1/Vihdoy/s-^ keyboav-d shov-tdut 



工 6AN DBFIMITBUY 
SBB 似 W 工 6AN USB AN APP 
BAR, MBSSA^B DIAL^^S, AMD 
ASYN^HR^N^US PR^RAMMIM^ 
lO BUIUD MY 6X6USB MAMAd^BR 
APPi BUT 工 , STIUU MISSING 
MY BINARYF^RMATTBR. WOV) 
X>0 I SBRIAUIZB MY 6X6US5 
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VO^UUDN , T IT BB DEBAMY IF THBRB 
WBEB A VJfWTO SAVB MY^BJBCTS 
THAT HAD AUU THE C^NVBNIBNCB 
O? BINARY SBRIAUIZATI^N, BUT WITH 
FIUBS THAT HUMANS CAN STILL I25A0 

ANL> 51>l 丁？ 


There is! It’s called data contract serialization. 

Writing text files is great, because you can just open up a file in 
Notepad and see what’s in it. But text files are also pretty lousy, 
because you need to write a lot of code to parse your data. 

Binary serialization with a BinaryFormatter is great because it’s 
so convenient. But it’s pretty lousy in its own way! Binary files are 
fragile. Make one tiny change to your class, and suddenly you 
can’t load any of your files anymore! And you’ve already seen the 
mess that appears when you open up binary files in Notepad. Good 
luck getting a human to read or edit a binary file. 

Data contract serialization is the best of both worlds. It’s true 


serialization, so entire object graphs are automatically written out 
for you. But it generates XML files, which turn out to be really easy 
to read and can even be edited by hand (especially if you’re used to 
working with XAML!). 


W\\tv\ you use bmav*^ scvializ«a*boh 
you’ve (- ish) ad 七 ual 

by*tcs m mcmov-y yt jlucd *toythcv 
d^d wvrbtc 朽 * to a 3lo^ jus*t 

'm-Povma*tio^ -pov b'mavy 
-Povma*t*tcv- *to -Pijuvc ou*t whidh by*tcs 
o^o v/i*th v/hidh dldss "m 

objcd*t Ov\t little bo jusi 

oY\t dlass, and suddenly ok *thc 


by*tcs [\Y\t u\> a^ymovc, ar>d wh ⑶ you 
*tvy *to dcscvializ^ you II yt a 灼 cvv-o\r. 
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A data contract is aw abstract definition 
of your object's data # " 

A data contract is a formal agreement that’s attached to your class. The contract 
uses the [ DataContract] and [ DataMember ] attributes to define exactly what 
data gets read or written during serialization. 

If you want to serialize instances of a class, you can set up a data contract for it 

by adding the [ Da taCon tract] attribute to the top, and [ DataMember] 

attributes to each class member to be serialized. Here’s a simple Guy class with a data contract: 

- The CPataCo^*tv-a^t3 CPataMcmbcv-3 aiiv-ibu*tcs 

using System.Runtime. Serialization; ^ m Syst ⑽ .Ru,t 时，如 叫说 . 



[DataContract] 

class Guy { 




[DataMember] 

public string Name 


get; private set; 


[DataMember] 

public int Age 


get; private set; 


[DataMember] 

public decimal Cash 


get; private set; 


Evcv-y ^lass membev that 灼 eeds *to be 

saved or \rctv-icvcd sc\rializ^*tio 灼 

is added h> the do 灼 *bra 匕 *t with b 

CPataMc^bcv-3 attv-ibu-tc. 


public Guy(string name, int age, decimal cash) 
Name = name; Age = age; Cash = cash; 


In the XML snippet for <Guy> below, 
xmlns is called an attribute, not a 
property. In your XAML files you’ll find 
tags with attributes like Fill, Text, and 
x:Name. The designer in the IDE calls 
them properties because they’re used 
to define properties on objects. 


Pata contract serialization uses XML files 

Luckily, you already know a lot about XML files, because XAML is an XML-based language. All XML files 
use opening tags, closing tags, and attributes to define data. Each member gets a name, but the contract itself 
also needs a name — or, more specifically, a unique namespace — because the serializer needs to be able 
to distinguish the data files for a contract from other XML files. Here’s the XML file that’s created when the 
Guy class on this page is serialized. As usual, we added spaces and line breaks to make it easier to read: 

<Guy xmlns= n http://schemas.datacontract.org/2004 / 07/XamlGuySerializer 
xmlns : i= n http://www.w3.org/2001/XMLSchema-instance M > 

<Age>37</Age> 

<Cash>164 • 38</Cash> / ^ da ' ta 3 士心 

, > o ^ iy \ ta<\. Inis is v/ay 

<Name>Joe</Name> \ — files! 




</Guy> 


move readable 


IVc ou\r p\rojcd*t 

)<aml^uy£cv-ialiicv ; a^d 
七 1 ^七 v/ 3 s *tu\r^cd m-feo "the 

(oy -the tonbr^t^. 
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more async methods 


,., lAsyncOperationKS'tcirageFile；' C re a t e F i le Asy n c ( st r i n g desiredNaiiie)^ 

.., IAsyncOperaticm<StGrage = ile> CreateFileAsync (string desiredNamej CreationCoIIisionOption options); 

， IAsyncOperation<StorageFclder> C re ate FoIde r Asy n c( st ri n g desiredNane)j 
,., IAsyncOperation<5torageFolder> CreateFolderAsync( string desiredNamej CreationCoIlisionOption options)^ 
, 』』 IAsyncOperation<Storage-ile> 6.et File Async (string name) j 

,,,IAsyncC , peration<5ystem-'Coll-ections.Generic. IReadOnlyList<StorageFiIe>> CetFilesAsync ( ); 

, 』』 IAs 7 ncC , peration<StorageFclder> 6etFolderAsync( st r ing name); 

』』』 IAsyncOpe"ati□ n<System.Coliections.Gene r ic.IReadOn lyL 1st <StorageFclder>> GetFoIdersAsync ()j 
d IAsyncOpe "ation<IStorageItei > Get IteinAsy n c ( st pin g name)i 

」』 ， IAsyncCperation<System-'Collections u Generic.IReadOnlyList<IStorageIter>> GetItemsAsync ()j 


▼ 


Each 工 StorageFolder object represents a folder in the filesystem, with methods to work with its files, including: 

* CreateFileAsync () is an async method to create a file in the folder. 

* CreateFolderAsync () is an async method to create a subfolder. 

* GetFileAsync () gets a file in the folder and returns an 工 Storage File object. 

* GetFolderAsync () gets a subfolder and returns another I StorageFolder object. 

* GetltemAsync () gets either a file or a folder, and returns an 工 Storage Item object. 

* GetFilesAsync (), GetFoldersAsync (), and GetltemsAsync () return collections of items — 
these methods return collections of type IReadOnlyList, a very simple kind of collection that lets you 
get items by index but doesn’t have methods to add, sort, or compare. 
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Use async methods to fmd and open files 

Data contract serialization works a lot like binary serialization. You need to open a file, create a stream 
for reading or writing, and then call methods to read or write objects. But there are differences, too: 
Windows Store apps have async methods for opening files. They’re based around the IStorageFile 
and I StorageFolder interfaces. You can use the IDE to explore these interfaces and discover their 
members. 

Go to any line in any method and type Windows . Storage. I StorageFolder, then right-click 
on I StorageFolder and choose Go To Definition (FI 2) to see the definition in the IDE: 

Class1.es* 


IStorageFolder [from metadata] 


H3 


Windows. Storage. I StorageFolder 


© GetltemsAsyncQ 


+ Assembly windows.winiinidj v255.255.255.255 


□ using System^ 
using Windows.Fou nd atio n j 
using Windows.Fo u nd atio n . Met ad at a; 


B namespace Windows.5torage 

]{ " 

+ 


/ 


ttcv-c^s dcdlav*a*tio^ 
(or IS-tov-ayFoldicv-- 


W\\cy\ you use 6{o To De*Pmrticm "to -Pmd 
'm-Pov-rwatio^ abou-b a dass ov 'm-tcv-Padc 
七 hat’s hot ih youir pv-ojedt, "the IVB 
v/ill o^CY\ a tab or\ the vijh-t like this. 


+ 


▲ 


public interface I Storage Folder :! IStorageltem 
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The Windows . Storage namespace has two additional interfaces to help 
you manage items in your file system. The IStorageFile interface and the 
objects that implement it (of course!) move, copy, and open files. And if you look 
closely at the declaration for I Storage Folder, you’ll see that it extends the 
工 Storageltem interface. IStorageFile extends the same interface, which 
makes sense if you think about the operations that apply to both files and folders: 
deleting, renaming, and getting the name, creation date, path, and attributes. 

Every Windows Store app has a local folder where it’s safe to read and write files, 
which you can access using an IStorageFolder called ApplicationData . 
Current. LocalFolder. Then you can use an IStorageFile object to 

open files for reading and writing by calling its OpenAsync () method 
(which returns an IRandomAccessStream). 

Once you have a data contract and a stream, you just need a new 

Da taCon tract Serializer, and you can read and write objects to XML files: 


I Storageltem 

Attributes 

DateCreated 

Name 

Path 


DeleteAsyncf) 

GetBasicProperties- 

Asyncf) 

IsOfTypef) 

RenameAsyncO 


using Windows.Storage; 
using Windows.Storage.Streams; 
using System.Runtime.Serialization; 

Guy joe = new Guy( n Joe M , 37, 164.38M); 

ttevVs a 与 uy with a data do 灼 *bra 匕七 -fv-om -the previous paje- 

DataContractSerializer serializer = 

new DataContractSerializer(typeof(Guy)); 


You’ll Y\Ctd 
•these us'm^ 
s*ta*temcr>*U- 


IStorageFolder 


IStorageFile 



ContentType 

FileType 

CreateFileAsyncf) 

CreateFolderAsyncf) 

GetFileAsyncf) 

GetFolderAsyncf) 

GetltemAsyncf) 

GetFilesAsyncf) 

GetFoldersAsync() 

GetltemsAsyncf) 

CopyAndReplaceAsyncf) 

CopyAsyncf) 

MoveAndReplaceAsyncf) 

MoveAsyncf) 

OpenAsyncf) 

OpenTransactedWrite- 

AsyncQ 



IStorageFolder localFolder = 

ApplicationData.Current.LocalFolder; 


The data CovSraci scHaliw heeds -to khow 
what type it s sc\riali 2 jhg. Wtrts how you -tdl it 
■to sc\rializ4! (^uy objects a^d theiv- gv-aphs. 


IStorageFile guyFile = await localFolder.CreateFileAsync( n Joe.xml n f 

CreationCollisionOption.ReplaceExisting); 


using (IRandomAccessStream stream = 

await guyFile.OpenAsync(FileAccessMode.ReadWrite)) 

using (Stream outputStream = stream.AsStreamForWrite()) { 

serializer.WriteObject(outputStream, joe); 

} 

Guy copyOfJoe; 



Vo[a pass 七 he 
Cv-ca-tcFilcAsy^dO a 
-filc^arwc a pavawtev 

\rcplatc, o^CY\, -fail, o\r 


ihc -file already exists. 


using (IRandomAccessStream stream = 

await guyFile.OpenAsync(FileAccessMode.ReadWrite)) 

using (Stream inputStream = stream.AsStreamForRead()) { 

copyOfJoe = serializer.ReadObject(inputStream) as Guy; 




tJovj 七 ha 七 y ou 
iiave ar\d 
output s-bvea^s, 
you CSv\ serialize 
youv- objc^*bs- 
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how your apps protect your files 


KnownFolders helps you access high-profile folders 


The Windows . Storage namespace includes the KnownFolders class, which has properties 
to help you access the documents library, music library, or other standard folder for a typical 
Windows account. KnownFolders . DocumentsLibrary is a StorageFolder object (which 
implements 工 StorageFolder) that you can use to access the current user’s documents library. It 
also has properties for the music, pictures, and video library, removable and media server devices, 
and home group. 

But there’s a catch. Windows Store apps are free to read and write to the local storage folder. But 
if you want your app to write to another folder, you’ll need to give it special permission by adding 
capabilities to the package manifest. When you explicitly allow your app to read and write to 
the local folder, anyone who installs it from the Windows Store can see that it has this capability. 


KnownFolders 

DocumentsLibrary 

HomeGroup 

MediaServerDevices 

MusicLibrary 

PicturesLibrary 

RemovableDevices 

VideoLibrary 


To add the documents library capability to your app, double-click on Package, appxmanifest 
in the Solution Explorer, click on the Capabilities tab, and check Documents Library. 


Libv-av-y bo yve 
youv- aff adless 
*to v"cad 
y/\ri 七 e -f iles m 

1'ibv-avy -foldcv*. 


4 StorageFile demo 


Pa dca g e.a ppxma n ifesf* 


□ X 


The properties of the deployment package for your app are contained in the app manifest file. 
You can use the Manifest Designer to set or modify one or more of the properties.. 


Application Ul 


Capabilitii 




Declarations 


Packaging 


▲ 


Use this pageto sp 


The \rcd C\>rt\tA X tha-t 
sorwcth'mg else you heed 
"to ^Oh-Pigu\rc. Hovc\r ovcv- it "to 
(md out what s Ic-Pt -fco do. 


If the documents library capability is declared,, then one or more file type associations must be added in the Declarations tab, 



ocument^ Library 
I I Enterprise Authentication 
0 Internet (Client) 


Descriptions 

This capability is subject to Store policy. See 
change, or delete fiIes in the Documents Lib 
Documents Library that are defined using tk 
Document Libraries on HomeGroup PCs. ▼ 


Click on the Declarations tab, choose File Type Associations from the drop-down, and click Add. This will bring up 
a form with two fields that have red circled X’s. Set Name to xml—file and the File type to .xml. 


You add move 
-f ile asso6a 七 I 。 ⑽ 
i-f you *to 
read diY\d 

kmds 

of -f iles. 


Save the manifest and close it. Now your app can read and write .xml files in the user’s documents library folder. 


Name: 


xml file 


Edit flags ^ 

] Open is safe 
]Always unsafe 

Supported file types 

At least one file type must be supported. Enter at least one file type; for example^ ".jpg' 


Supported filetype 

Content type: 

File types ,xml 


Remove 
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async await and data contract serialization 


The whole object graph is serialized to XML 

When the data contract serializer writes an object, it goes through the entire object graph. Every instance of 
a class with a data contract is written to the XML output. You can customize the XML output by choosing a 
namespace and naming members using parameters of the DataContract and DataMember attributes. 


’http://www.headfirstlabs.com/Chapter11 n )] 


[DataContract(Namespace = 
class Guy { 

public Guy(string name, int age, decimal cash){ 
Name = name; 

Age = age; 

Cash = cash; 

TrumpCard = Card.RandomCard(); 


[DataMember] 

public string Name { get; private set; 
[DataMember] 

public int Age { get; private set; } 
[DataMember] 

public decimal Cash { get; private set; 

[DataMember(Name = M MyCard M ) ] 
public Card TrumpCard { get; set; 


public override string ToString () { 

return String.Format( M My name is 
+ "and my trump card is {3} M 


Here's the\XML for the serialized Guy ： 

<Guy 

xmlns= M http: / /www.headfirstlabs.com/Chapter11" 
xmlns : i="http://www.w3.org/2001/XMLSchema-instance M > 
<Age>37</Age> 

<MyCard> 

<Suit>Hearts</Suit> 

<Value>Three</Value> 

</MyCard> 

<Cash>176.22</Cash> 

<Name>Joe</Name> 

</Guy> 


The ^uy dewtams a 

-to a Cavd objed-t 
v/_ 七 h a data so 

it jets mdludcd \ y \ ihc 
)<ML as a <Cav-d> tag. 


{0}, I'm {1}, I have {2} bucks , 
Name f Age, Cash, TrumpCard); 


Data contract member names don’t 
need to match property names. This 
Guy class has a property called 
TrumpCard, but we used the Name 
parameter of the DataMember 
attribute to give it the name 
MyCard. That’s what shows up in 
the serialized XML. 

Did you notice that the serialized 
XML does not contain the Card type? 
That’s because you can add these 
data contract attributes to any class 
with compatible members — like 
the Suit and Value properties of 
the Card class, which the serializer 
knew how to set using values like 
Hearts and Three by matching 
with corresponding enum values. 


[DataContract(Namespace = "http :// www.headfirstlabs.com/Chapterll")] 


class Card { 

[DataMember] 

public Suits Suit { get; set; } 
[DataMember] 

public Values Value { get; set; } 

public Card(Suits suit, Values value) 
this.Suit = suit; 
this.Value = value; 


\ Both 

av-c \ y \ -the same 

becomes -the >cnr\Ls 
pvopev-ty o( -the 
<^uy> taj \ y \ 七 he 
scvializjcdl )(A1L. 


private static Random r = new Random(); 


public static Card RandomCard() { 

return new Card((Suits)r.Next 

} 

public string Name { 

get { return Value.ToString() 

} 

public override string ToString () 


(4), (Values)r.Next(1 , 14)); 


+ M of ’▼ + Suit. ToString () ; } 

{ return Name; } 


you are here ► 
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those guys get around 

Stream some &uy objects to your app's local folder 



Here’s a project to help you experiment with data contract serialization. Create a new Windows Store app 
and replace the MainPage.xaml with a new Basic Bage. Then open Package, appxmanifest, enable access to 
the documents library，and add the .xml file type. Add both classes with the data contracts from the previous 
page (you’ll need using System. Runtime . Serialization in each of them). And add the familiar 
Suits and Values enums, too (for the Card class). Here’s the page you’ll build next: 


Guy Serializer 

My name is Joe, I'm 37,1 have 1762Z My name is Bob, I'm 45,1 have 4.68 
bucks, and my trump card is Seven of bucks, and my trump card is Three of 
Clubs Clubs 

My name is Ed, I'm 43,1 have 37.51 
bucks, and my trump card is Ten of 
Hearts 

Write Joe Write Bob 

Write Ed 

Last filefiame written 


1 C:\Users\Public\Documeint5\Guys\Joe.xmll 1 

Read a new Guy 

Date created 

1/15/2013 5:24:12 PM -05:00 

Content type 

text/xml 

New Guy: 



Add a static GuyManager resource to the page (and set the app name). 
You’ll add the GuyManager class on the next page. 

<Page.Resources 〉 

<local : GuyManager x : Name= M guyManager" / > 

<x : String x : Key= n AppName">Guy Serializer</x:String> 



V^u add crwpty 

dass -to yt 
v-id o( the IDE CV-V-olr -Polr 
七 his taj—youll -fill i-t \v\ OY\ 

the paje. Vor\i -fovjci 
to vebuild the solution a-fiev 


</Page.Resources 〉 


you add ihc empty dass 
■fco yt vid of Bv\y evrov 
rwessajes m the dcsi^cv-. 
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async await and data contract serialization 


❺ Here’s the XAML for the page. 


<Grid Grid.Row= M 1" DataContext: 
<Grid.ColumnDefinitions> 
<ColumnDefinition/> 
<ColumnDefinition/> 
<ColumnDefinition/> 

</Grid.ColumnDefinitions> 

<Grid.RowDefinitions> 
<RowDefinition/> 
<RowDefinition/> 

</Grid.RowDefinitions> 


{StaticResource guyManager}" Margin="120 f 0"> 



TKc pay Kas 

•tKvcc dolur«y>s 
dr>d b*to voy/s. 



TKc yid’s da*ta 

do 灼七 wt ’is 七 he 
static vcsouvd 


/ 



i-diCM dolumir) m 
"the "top \row has 

a StadkPar>cl 
wi-th a Tc^iBlodk 

如 d a 


<StackPanel> 

<TextBlock Text="{Binding Joe}" Style= M {StaticResource 工 temTextStyle} n 
Margin= M 0 , 0,0,2O'，/> 

〈Button x : Name="WriteJoe" Content="Write Joe" Click="WriteJoe_Click" / > 

</StackPanel> 

<StackPanel Grid.Column="1 M > 

<TextBlock Text=" {Binding Bob}’' Style=" { StaticResource 工 temTextStyle }，' 

Margin= n 0,0,0,2 0，'/> 

〈Button x : Name= n WriteBob" Content="Write Bob" Click="WriteBob_Click n / > 

</StackPanel> ThisUBlo 乙 k is bou^d b> the 

<StackPanel Grid. Column="2 M > pyopeyty m 

<TextBlock Text="{Binding Ed}" Style="{StaticResource 工 temTextStyle}，' 

Margin= M 0 , 0,0,2 0，'/> 

〈Button x : Name= n WriteEd" Content="Write Ed" Click= n WriteEd_Click M / > 

</StackPanel> _ The ^si , c ll i, the bot^ 

<StackPanel Grid. Row= M 1" Grid. ColumnSpan="2" Margin= M 0 f 0,20 f 0"> |rov/ sp^hs two dolurvths. H 

<TextBlock>Last filename written</TextBlock> ^oh"t\rols bouhd "to 

<TextBox Text= n {Binding Path, Mode=TwoWay} " Margin= n 0,0,0,20，'/> p^ropcv-tics. IVhy do you ihihk we 
<TextBlock>Date created</TextBlock> used a Tcx-fcBox -Po\r the path? 

<TextBlock Text="{Binding LatestGuyFile.DateCreated}" Margin= n 0,0,0,20" 

Style="{StaticResource SubheaderTextStyle}"/> 

<TextBlock>Content type</TextBlock> 

<TextBlock Text 二 "{Binding LatestGuyFile.ContentType} 


Style="{StaticResource SubheaderTextStyle}"/> 


</StackPanel> 


<StackPanel Grid.Row= M 1" Grid.Column="2 M > 

<Button x : Name="ReadNewGuy" Content="Read a new Guy" Click: 
Margin="0,10,0,0"/> 


You can bind a control to a property 
on an object. LatestGuyFile 
is an IStorageFile, and these 
TextBlock controls are bound to its 
properties. 


'ReadNewGuy Click' 


<TextBlock Style= M {StaticResource 工 temTextStyle} n Margin= n 0,0,0,20 n > 
<Run>New Guy : </Run> 

<Run Text="{Binding NewGuy}"/> 

〈 /TextBlock 〉 _ 

</StackPanel> 

</Grid> 


-► 


Wre not done yet-flip the pa^e! 


you are here ► 
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think about separation of concerns 


V^ull y\tcd -these usmg 
-Pov 七 he ^uy/Vla^ajcv dlass. 


■> 


❺ Add the GuyManager class. 


class GuyManager : 工 NotifyPropertyChanged 

{ 

private 工 StorageFile latestGuyFile; 
public 工 StorageFile LatestGuyFile { get 


using System.ComponentModel; 
using Windows.Storage; 
using Windows.Storage.Streams; 
using System • 工 0; 

using System.Runtime.Serialization; 


37 


45, 4.68M) 


private Guy joe = new Guy( M Joe' 
public Guy Joe 
{ 

get { return joe; } 


private Guy bob = new Guy("Bob' 
public Guy Bob 
{ 

get { return bob; } 

} 


private Guy ed = new Guy("Ed M , 43, 37.51M) 
public Guy Ed 
{ 

get { return ed; } 

} 

public Guy NewGuy { get; private set; } 


return latestGuyFile; 
176.22M); 


^icld i\\\s fvofcv-ty 
is sc*t by i\\t 

toured -to its Pa*tcCvca*tcd a^d 
Corrtc^tTyfc fvofcrtics. 


Thc\rc a\rc -th\rCC \rcad-o^ly 

与 uy properties with pv-ivaic 
bWmg -fields. The )<AML has a 
TcxiBlo^k boui^d bo ca^h o( them. 


J\ -fourth Tt%id\oCM is bou^d *to 
七 his ^uy p\rofC\rty> v/KitK is sc*t 
by i\\t Rcad^uyAsy^O method. 


public string Path { get; set; 


You can use the static StorageFile. 
GetFileFromPathAsync () method to 
create an IStorageFile from a string path. 


public async void ReadGuyAsync() 

{ 

if (String • 工 sNullOrEmpty(Path)) 
return; 

latestGuyFile = await StorageFile.GetFileFromPathAsync(Path); 


using ( 工 RandomAccessStream stream = 

await latestGuyFile.OpenAsync(FileAccessMode.Read)) 
using (Stream inputStream = stream.AsStreamForRead()) 


DataContractSerializer serializer = new DataContractSerializer(typeof(Guy)) 
NewGuy = serializer.ReadObj ect(inputStream) as Guy; 


OnPropertyChanged("NewGuy"); 
OnPropertyChanged("LatestGuyFile"); 


The Rcad^uy/\sy^dO method uses -the path m -the 
Te^iBo% io sci ihc hicsi^uyFilc l£io^cFile -field- 
I 七 uses ihc scv-ialiicv io read ihc objed-b -Pvom ihc 
)<ML -Pile, then -Piv-cs o^-P Pvopcv-tyCha^jcd cve^-ts 
(or pv-opcv-*tics -that use (S-tovajcFilc attributes. 
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async await and data contract serialization 


This ^\rcaics a -Poldcv called ^uys m -the 
do6_e>vts lib\ra\ry -to hold the X^IL -files. {( ii 
y ^l^cady c^is-ts, -the -folder is opened- 


This todc 
dv-ca*tcs the 
)<ML -Pile, opc^s 
a s*tv"caw>, 
y/\ri*tcs *thc 与 uy 
object jv-aph 
*bo it 


public async void WriteGuyAsync(Guy guyToWrite) 

{ 

工 StorageFolder guysFolder = 

await KnownFolders.DocumentsLibrary.CreateFolderAsync("Guys n , 

CreationCollisionOption.OpenlfExists); 

latestGuyFile = 

await guysFolder.CreateFileAsync(guyToWrite.Name + ".xml ", 

CreationCollisionOption.ReplaceExisting); 


using ( 工 RandomAccessStream stream = 

await latestGuyFile.OpenAsync(FileAccessMode.ReadWrite)) 
using (Stream outputStream = stream.AsStreamForWrite()) 

{ 

DataContractSerializer serializer = new DataContractSerializer(typeof(Guy)); 
serializer . WriteObj ect (outputStream,. guyToWrite); 


Path 二 latestGuyFile.Path; 

OnPropertyChanged("Path"); 
OnPropertyChanged("LatestGuyFile"); 


TV l^v'i-tc^uvAsy^dO method … vi 七 es a yy 
•to )<yV]L +ilc a 今 uys -foldcv inside i\\t 
libvavy. I*t sets latestGuyFile 
iS-tovagcFilc -f ield -bo po*m*b *to -rile *>*t 
Yoit, 払⑼ it ^ives fvopcvty c\\a^A 
•ts -fov pvofcvtics -tKa-t use held. 


w 
even 


public event PropertyChangedEventHandler PropertyChanged; 

private void OnPropertyChanged(string propertyName) 

{ 

PropertyChangedEventHandler propertyChangedEvent = PropertyChanged; 
if (propertyChangedEvent != null) 

{ 

propertyChangedEvent(this, new PropertyChangedEventArgs(propertyName)); 



Here are the event handler methods for MainPage.xaml.es.. 


private void WriteJoe_Click(obj ect sender, RoutedEventArgs e) 
guyManager.WriteGuyAsync(guyManager.Joe); 


ttcv-c^s ihc same Codt you 
used ca\rlic\r "to irwplcrwc^-t 

l/Vo-ti-fyP\ropc\rtyChahgcd a^d 

•five o^f P\rope\rtyCh 扣 ged 


private void WriteBob_Click(obj ect sender, RoutedEventArgs e) 
guyManager.WriteGuyAsync(guyManager.Bob); 

} 

private void WriteEd—Click(object sender, RoutedEventArgs e) 
guyManager.WriteGuyAsync(guyManager.Ed); 


private void ReadNewGuy_Click(object sender, RoutedEventArgs e) 
guyManager.ReadGuyAsync(); 


you are here ► 
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what is a task in real life? 


Take your ftuy Serializer for a test drive 


Use the Guy Serializer to experiment with data contract serialization: 

* Write each Guy object to the Document Library folder. Click the ReadGuy button to read the guy that was 
just written. It uses the path in the TextBox to read the file, so try updating that path to read a different guy. 
Try reading a file that doesn’t exist. What happens? 

* Open up the Simple Text Editor you built earlier in the chapter. You added XML files as options for the open 
and save file pickers, so you can use it to edit Guy files. Open one of the Guy files, change it, save it, and read 
it back into your Guy Serializer. What happens if you add invalid XML? What if you change the card suit or 
value so it doesn’t match a valid enum value? 

* Your Simple Text Editor doesn’t have a New button that resets it to untitled. Gan you figure out how to add 
one? (You can also just restart it.) Try copying a Guy file, then pasting it into a new XML file in the Guys folder. 
What happens when you try to read it into the Guy Serializer? 

* Try adding or removing the DataMember names ([ DataMember (Name= M What does that do 

to the XML? What happens when you update the contract and then try to load a previously saved XML file? 
Gan you fix the XML file to make it work? 

* Try changing the namespace of the Card data contract. What happens to the XML? 



Dumb Questi9ns 

I didn’t set the app capabilities in 
my Simple Text Editor. Why was it able to 
write to my documents library? 

When your app uses the File Picker, 
the user can gain access to files and folders 
without setting app capabilities in the 
package manifest because the File Picker is 
built to keep your filesystem safe: the pickers 
won’t let you access install folders, local 
folders, temporary folders, and a lot of other 
unsafe locations in your filesystem that your 
app could accidentally damage. You only 
need to set capabilities if you need to write 
code to access locations directly. 

Sometimes I make a change in my 
XAML or my code, and the IDE’s designer 
gives me a message that I need to rebuild. 
What’s going on? 

The XAML designer in the IDE is really 
clever. It’s able to show you an updated page 
in real time as you make changes to your 
XAML code. You already know that when the 
XAML uses static resources, that adds object 
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references to the Page class. Well, those 
objects need to get instantiated in order for 
them to be displayed in the designer. If you 
make a change to the class that’s being used 
for a static resource, the designer doesn’t 
get updated until you rebuild that class. That 
makes sense—the IDE only rebuilds your 
project when you ask it to, and until you do 
that it doesn’t actually have the compiled 
code in memory that it needs to instantiate 
the static resources. 

You can use the IDE to see exactly how this 
works. Open your Guy Serializer and edit the 
Guy. ToString () method to add some 
extra words to the return value. Then go back 
to the main page designer. It’s still showing the 
old output. Now choose Rebuild from the Build 
menu. The designer will update itself as soon 
as the code finishes rebuilding. Try making 
another change, but don’t rebuild yet. Instead, 
add another TextBlock that’s bound to a Guy 
object. The IDE will use the old version of the 
object until you rebuild. 

I’m confused about namespaces. 
How is the namespace in the program 
different from the one in an XML file? 


Let’s take a step back and understand 
why namespaces are necessary. C#, XML 
files, the Windows filesystem, and web pages 
all use different (but often related) naming 
systems to give each class, XML document, 
file, or web page its own unique name. So 
why is this important? Well, let’s say back 
in Chapter 9, you created a class called 
KnownFolders to help Brian keep 
track of excuse folders. Uh oh! Now you find 
out that the .NET Framework already has a 
KnownFolders class. No worries. The 
■NET KnownFolders class is in the 
Windows.Storage namespace, so it can exist 
happily alongside your class with the same 
name, and that’s called disambiguation. 

Data contracts also need to disambiguate. 
You've seen several different versions of 
a Guy class throughout this book. What if 
you wanted to have two different contracts 
to serialize different versions of Guy? You 
can put them in different namespaces to 
disambiguate them. And it makes sense that 
these namespaces would be separate from 
the ones for your classes, because you can’t 
really confuse classes and contracts. 


async await and data contract serialization 


Use a Task to call owe async method from another 

When you mark a method with the async modifier, that method can also be awaited by other async 
methods. But you’ll need to make one change to an asynchronous method in order to do that. Try adding 
this method to your GuyManager.es.. 

private async void Met hodT h at Re ad sG uy s () 



You’ll get an error, with a squiggly underline — and a very useful error message in the Error List window: 


Error List 



O 1 Error 1e::acje: Search Error List 


P 


Description 


TV IDE is 七 el I mg you 
exactly y/ha-t you y\ttd 
h> do h> -fix. the pv-oblcm. 


1 'XamIGuySeriailizer.GuyManager„ReadGuyQ 1 does not retyrni a Task and cannot be 
awaited；. Consider changing il to return Task. 


In order to make one async method call another, the method being called has to have the return type be the 
Task class (or its subclass, Task<T>, if the method needs to return a value). Since ReadGuy () has a void 
return value, all you need to do is replace void with Task in the declaration: 


public 

{ 

// 

} 


async Task 
Same as on 


ReadGuyAsync() 
the previous page 


The recommended naming convention is 
to add Async to the end of the method 
name for any asynchronous method that 
should be called with the await operator, 
so we’ll change the name of this method 
from ReadGuy () to ReadGuyAsync () • 


Now the method can be called with the await operator, and it will act just like any other asynchronous 
method and return control when it hits an asynchronous operation. If you wanted the method to return a 
value, you’d make it type Task<T>. For example, if you wanted ReadGuyAsync () to return the Guy 
object that it read, you would change its return type to Task<Guy>. 



IM 126AL UIF6, A TASK IS SOMETH ITHAT NJ66DS 
TO B6 SO IS A Task O^. Task<T> ^3JBCT A WAY F^>12 

A METHOD TO 126TU12M SO/^B SO^T O'? 

THAT 12UNJS AM ACTION? 



Yes! The Task class represents an asynchronous operation. 


The async modifier, await keyword, and Task class make writing asynchronous code easier, 
and the way they do that is by encaspulating all of the work of yielding control into that Task 
class. Use “Go to Definition” to have a quick look at the properties and methods of the Task class. 
It has methods like Run (), Continue (), and Wait (), and properties like 工 sCompleted and 
工 sFaulted. This should give you a hint about what’s going on behind the scenes...and all of the 
things it does automatically in order to make it easier to write asynchronous methods. 

You can read more about asynchronous programming here: 
http://msdn.microsoft.com/en-us/librarv/vstudio/hh191443.aspx 


you are here ► 
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concerned citizens 


Puild Priaw a wew Excuse Manager app 

You know how to build XAML pages, read and write files, and serialize objects. It’s time to 
put all of the pieces together and rebuild Brian his Excuse Manager as a Windows Store app. 

Here’s the main page: 


Excuse Manager 


Excuse 


I had to lakB my cat to te therapist appcrntment 



The boss really believes in good mental healch Fc-i pets! 


Last Used 


1/26/2013 12:^9:59 PM 


Set to current time 


File Date 


1/26i/zcnj PM -05:00 


® ® @ ® ( 5 ) ® 




Rarxiom Excuse Open 


鄉 lA/mdoy/s S-torc a\>\>s *m i\\t Visual Siudio simulator 




S« “ rt 啊 ⑽ ds *to Wbd tar. be ^ally (TV..s ,s a s.mulaW , ⑽七孙 emula ^ 


, ,,I lb- Loc^lTyiachine^n t \^oost ► Simul ator] y ou ⑽ 

To s-tavt simula*to\r ； dlitk *tiiC dvop - dovm avrov/ to j \ j ^ x_ 

you , p 哼 a J ⑽产矸卜 II UWrn a s-^ula^ iV,ai sW ^w.ll {o All - 伽⑶ Wbd “ 代 ⑽ U 

Lea,, mce aboui ,av ， 3 atm 3 iV,e s _l“ 
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async await and data contract serialization 


Separate the page, excuse, and Excuse Manager 

Your old Excuse object knew how to read and write itself, and that’s not a bad way to 
design your objects. But there are other design choices that you can make. Your Guy 
Serializer app had the information about the Guy in one class, and methods to read and 
write Guy objects in the GuyManager class. You’ll follow the same pattern for the new 
Excuse Manager app. 

That’s another example of the separation of concerns design principle that we talked 
about back in Chapters 5 and 6. The Guy just needs to expose the data contract; it’s up to 
another class like GuyManager to determine what to do with that contract. And neither of 
those classes has any code for updating the user interface, because it’s not concerned with 
displaying the excuse — that’s the MainPage object’s job. 


The n\^\Y\ pa<\c does/ 七 have Code 



c 

Qdo 


•to dhoosc -iroldcv-s, or v-cad o\r wv-i-tc 
•files. AH o-P ihai toAt is 
•m 七 he dass. 


Click event handily 
calls ChooseNewFolder f 




TWO-WAY BII\ T l>I!\ T (i 




NewExcuseAsyncf) 

SetToCurrentTimef) 

ChooseNewFolderAsync() 

OpenExcuseAsyncf) 

OpenRandomExcuseAsync() 

SaveCurrentExcuseAsyncf) 

UpdateFileDateAsyncf) 

SaveCurrentExcuseAsAsync() 

WriteExcuseAsyncf) 

ReadExcuseAsyncf) 


The pajc doirbrols bmd 
■to 七 he E^duscMa^ajcv 
object, y/hidh veads and 
wviics E^cdusc objects. 


Excuse 


Description 

Results 

LastUsed 

DateWarning 


The do^*tvols ot\ the pajc display data us'mj data 
The 七 wt bo%cs have *tv/o-way b'md'mj 
stv-ai^*t *to fv-ofC\rtics oy \ the duv 卞⑶七 £^usc 

object exposed by *tKc E^uscMa^ajcv. 




Results 
property 



°0se ^ 



The Excuse and ExcuseManager classes don’t have any code for updating the user interface. 
Plus you can use data contract serialization or asynchronous programming in a WinForms 
program. Could you use them to adapt the Windows Forms version of Brian’s Excuse Manager 
to read and write the same excuse files as your new Windows Store Excuse Manager? 


you are here ► 
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symbolic gesture 


Create the mam page for the Excuse Manager 

Create a new Windows Store app project and replace MainPage.xami with, a new 
Basic Page. You’ll need a static ExcuseManager resource. Add an empty ExcuseManager 
class so your code compiles, then add it as a static resource to 〈Page .Resources 〉： 



this! 


/ - 


<Page.Resources 〉 

<local : ExcuseManager x : Name="excuseManager" / > 

<x : String x : Key= n AppName">Excuse Manager</x:String 〉 
</Page.Resources 〉 


Here’s the XAML for the page — it’s a simple StackPanel-based layout. Set the data 
context for the StackPanel to the ExcuseManager resource. 


Excuse 


therapist appeintment 


Results 


The bess really believes in good mental health For 


Last Used 


1/26/2013 12:^9:59 PM 


File Date 

PM-05:00 


Sells eurrertt time 




ttavc a look m i\\t -toolbo%. T\\tyts y\o UysM 
Jpov da*tcs| We'll use a ^rc^ulav Tt%ido% 

doy>iv-ol aY\d a bu 七 *to 灼 *to se*t |七 *to the du\r\rcir>*t 
time. We'll also -take adva^ia^c o-f bu’il 七一 m MBT 
methods dar> dor^vc\rt b> a Da 七 eTime. 


〈StackPanel Grid.Row= M 1 M Margin= n 120,0,0,0 n 

DataContext= M {StaticResource ResourceKey=excuseManager} M > 

<TextBlock Style= M {StaticResource SubheaderTextStyle} M Text= M Excuse M Margin= M 0,0,0,10 M /> 
<TextBox Text= M {Binding CurrentExcuse.Description, Mode=TwoWay} M Margin= M 0,0,20,20 M /> 
<TextBlock Style= M {StaticResource SubheaderTextStyle} M Text= M Resuits" Margin= M 0,0,0,10 M /> 
<TextBox Text= M {Binding CurrentExcuse.Results, Mode=TwoWay} M Margin= n 0,0,20,20 n /> 

<TextBlock Style= M {StaticResource SubheaderTextStyle} M Text= M Last Used" Margin= M 0,0,0,10 M /> 
<StackPanel Orientation= M Horizontal" Margin= M 0,0,0,20 M > 

CTextBox Text= M {Binding CurrentExcuse.LastUsed, Mode=TwoWay} M 

MinWidth= M 300" Margin^"0,0,20,0 M /> 

〈Button Content= M Set to current time" Click= M SetToCurrentTimeClick" Margin= n 0,0,20,0 n /> 


<TextBlock Foreground= M Red M Text= M {Binding CurrentExcuse.DateWarning} M 

Style= M { StaticResource SubtitleTextStyle } M / > usev* C^*tcV"S irwdlid dd'tc ； "the 

〈 /StackPanel 〉 -field will Ii 3 vc B v/ 3 \nr»ihj 

that jets displayed m 七 his Tc^tBlodk. 


<TextBlock 
<TextBlock 
</StackPanel> 


Style= M {StaticResource SubheaderTextStyle} M Text= M File Date" Margin= M 0,0,0,10 M /> 
Text= M {Binding FileDate} M Style= M {StaticResource 工 temTextStyle} n /> 


Tt^ido% to^ols Kavc a W-v/ay da*ta bmdnr^ 
*to pvopcv"*t*ics or\ *tV>c Cuvv ⑼七 objcd*t 

dass. The Ic^Blodk -fov *tKc -f ile 
•,s bouy>a -to PilcPatc p^ropc^rty. 
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Add the app bar to the mam page 


;ync a 


wait and data contract serialization 


Add a bottom app bar to the page. You’ll need to uncomment OpenFileAppBarButtonStyle ， 丁 heve’s a "typo ih 
SaveAppBarButtonStyle, and FolderppBarButtonStyle for the Open, Save, and Folder , S-ta^dav-dS-tylcs.^aml -file 
buttons. 一 ^ -tha-t mi-tially shipped wilh 

\/isual S'tudio 2-Ol2~ v/hcv*c 
七 he “A” wds out op 
Foldc\rAppBa\rBu-t-to^S-tylc. 



S) 


(3) 


© 




⑧ 




Excuse 


FoWer 


Random Excuse 


Open 


Save 


Save as. 


heed "to add a Bot-fcom/\ppBav- 
< -to the fage, just like you did wi-th 

the Simple Text EdiW. 


Use these 
p\ropcv-*tics -to 

the 

button name 

i 乙 orv 


<common : LayoutAwarePage.BottomAppBar> 

<AppBar x : Name= M appBar M > 

<StackPanel Orientation= M Horizontal" HorizontalAlignment= M Right M > 

〈Button Style= M {StaticResource AppBarButtonStyle} M Click= M NewExcuseButtonClick M 
- > AutomationProperties.Name= M New Excuse" Content= M &#x26Fl;"/> 

<Button Style= M {StaticResource FolderppBarButtonStyle} M Click= M FolderButtonClick M /> 
〈Button x : Name= M randomButton M Style= M {StaticResource AppBarButtonStyle} M 
- - >■ AutomationProperties.Name= M Random Excuse" Content= M &#x2047; M 

工 sEnabled= n False n Click= M RandomExcuseButtonClick M / > 

<Button Style= M {StaticResource OpenFileAppBarButtonStyle} M 

AutomationProperties.Name= M Open M Click= M OpenButtonClick M / > 

〈Button x : Name= M saveButton" Style= M {StaticResource SaveAppBarButtonStyle} M 

工 sEnabled= n False n Click= M SaveButtonClick M /> ^_ 

〈Button Style= M {StaticResource SaveAppBarButtonStyle} M 

AutomationProperties.Name= M Save as ... M Click= M SaveAsButtonClick M / > 

</StackPanel> 

</AppBar> 

</common : LayoutAwarePage.BottomAppBar> 

So how did that XAML change the picture in the button? Have a close look at one of the styles that you uncommented 
in StandardStyles.xaml and you’ll see hex values like &#xE188; for the folder and &#xE 1A5; for the Save button. The 
button content is just text in the Segoe UI Symbol font, and the icon is a Unicode character in that font. 


The Save 

E 从 use 
buttes av-c 
disabled. 


Character Map 


n 


Font : 


0 Segoe UI Symbol 


Help 


ft 


Q 


赛 



、 


A 


9P 




cf 

V 

5 

O 

O 

參 

0 

OD 

oc 

oo 

c= 


9 

? 


f 




* 

y 

A 

Q 
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© 

m 

a 

a 


s 



m 

罾 


D 

■ 

囹 

X 


炒 



A 


S8 

e 

K 


<9> 

■ 


9 « 

\~7 

j 1 



m 



6 

0 

女 

女 

女 

\ 


谷 


FT 

A 

n 

• 

•攀 

o 

-0- 


r 

a 


r ^ 

A 

A 


A 

8 

X 

丄丄 

i) 

□ 

F 



Y- 





% 


▲ 

V 



"V 





✓ 

3 & 


V 

V 

X 

X 

X 

X 

+ 

+ 

+ 


t 

寸 

t 

> 





v 

♦ 

今 


☆ 

o 

☆ 

★ 

★ 

★ 


☆ 

> 




睾 

本 

彝 


m 

# 



氺 

* 



$ 

O 




尜 

\b> 

木 

* 


糸 

糸 

X 

o 


□ 

IJ 

□ 


7 

> 

< 

*> 

1 

i 

i 

1 

4 

» 



9 


/s 


To cr^bed a hex value inside a XA/WL -Pile 

(广 any XML ^ add h> the 

bcgihhihg a^d ; {x> the Chd o-f the value. 


Content= n &#x2 6F1 


If 


Characters 
O Adv< 


ters to copyj^x^j 
;arjped^view 


Select 


Copy 



Well dive m-fco styles "to 
u^dev-s-tahd how 

"they v/ovk latev" oh m 
七 he book. 




U+26F1: Umbrella On Ground 


Wtrts hov/ you srt i\\t button Mmc. 


AutomationProperties.Name= 

"Random Excuse 11 


► you are here ► 


Next comes the ExcuseMana^er class 
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no more excuses 


Puild the ExcuseManager class 


po^*b -Po\r^c*b *to make 七 he — $ 
E^uscMa^a^cv ^lass imflemerrb 
I Koti-fyPvofcrtYOia^^cd. 


Here’s most of the code for the ExcuseManager class — you’ll finish the rest of the class and 
build the Excuse class as an exercise. It has two public properties for binding: CurrentExcuse 
is the currently loaded Excuse object, and FileDate is a string that either shows the file date or 
the string " (no file loaded) n (if the current excuse hasn’t been saved or loaded). 


The ChooseNewFolderAsync () method shows a folder picker, and returns true only if 
the user chose a folder. Since it’s an async method that returns a bool value, its return type is 
Task<bool>. 


public Excuse CurrentExcuse { get; set; } 


ExcuseManager 

CurrentExcuse 

FileDate 

NewExcuseAsyncf) 

SetToCurrentTimef) 

ChooseNewFolderAsyncf) 

OpenExcuseAsyncf) 

OpenRandomExcuseAsync() 

SaveCurrentExcuseAsync() 

UpdateFileDateAsyncf) 

SaveCurrentExcuseAsAsync() 

WriteExcuseAsync() 

ReadExcuseAsyncf) 

— 


public string FileDate { get; private set; } 

private Random random = new Random(); 
private 工 StorageFolder excuseFolder = null; 


private 工 StorageFile excuseFile; 

The c^duscFilc iS-feov-agcFilc pv-opcv-ty 

public ExcuseManager () { keeps brac\c o( Ihc 

} NewExcuseAsyncO; ^ ^ ^ ^ ^⑽七 

e 从 use has〆 七 been loaded oy saved. 


You’ll need these using statements: 

using System.ComponentModel; 
using System • 工 0; 

using System.Runtime.Serialization; 
using Windows.Storage; 
using Windows.Storage.Streams; 
using Windows.Storage.FileProperties; 
using Windows.Storage.Pickers; 
using Windows.U 工 •Popups; 

Task is m the Systcm.Thvcadmj.Tasks 

bu*t the IPE already added that us'mj statement. 


async public void NewExcuseAsync() 
CurrentExcuse = new Excuse(); 
excuseFile = null; 
OnPropertyChanged("CurrentExcuse") 
await UpdateFileDateAsync(); 


public void SetToCurrentTime() 


-the usev didks -the 
Ncv/ bu*btoi^ 

v-csc-b its 

匕 uvvcjrrt 灼 ddlls 

Upda*tcFilcDa*tcAsy^dO h> 
update the FileDate i 


pv-opc\rty. 


You can call an async method 
like NewExcuseAsync () from 
a regular, non-asynchronous 
method. Just leave off the 
await keyword and the method 
will block. The IDE will give you 
a warning to make sure this is 
_what you want to do._ 


CurrentExcuse.LastUsed = DateTimeOffset.Now.ToString(); 
OnPropertyChanged("CurrentExcuse"); 


This method sets *thc LasiUscd s-tv-mj -fco -the 
duv-v-c^t Bv\d -fives a Pv-opcv-tyCha^jcd 

public async Task<bool> ChooseNewFolderAsync() { 

FolderPicker folderPicker = new FolderPicker() { 

SuggestedStartLocation = PickerLocationld.DocumentsLibrary 


folderPicker.FileTypeFilter.Add(".xml"); 

工 StorageFolder folder = await folderPicker.PickSingleFolderAsync(); 

if (folder != null) { W He usev pidked a 七 he me 七 hod 代七价⑽ 

*bruc. method -that v~c*tu\nr\s a 7ask<bool> 

\us-t \rc*tu\r^s bool value ds usual- 


TVis Bs>jy\t\\rov\o\AS mc*biiod 

v*dv* 灼 s a bool v3luc> so i*ts 
v"c*b^v"r\ *byfc is lask<bool>. 


excuseFolder 
return true; 


folder; 




MessageDialog warningDialog = new MessageDialog("No excuse folder chosen ，'）； 
await warningDialog.ShowAsync(); 
return false; 




The FolderPicker is another picker that lets you choose a folder. It works just like the 
other pickers you’ve seen. Have a look at all of the pickers in the Windows . Storage. 
Pickers namespace: htti3://msdn.microsoft.com 川 brarv/windows/aops/BR207928 
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public async void OpenExcuseAsync() { 

FileOpenPicker picker = new FileOpenPicker { 

SuggestedStartLocation = PickerLocationld.DocumentsLibrary, 
CommitButtonText = "Open Excuse File" 


async await and data contract serialization 

餐 




picker.FileTypeFilter.Add(".xml M ); 

excuseFile = await picker.PickSingleFileAsync() 

if (excuseFile != null) 

await ReadExcuseAsync(); 


The ) method is jus-t like "the 

method m ^uy Scv-ializ^v - . 


Uh oh! There's a bug somewhere 
around here. Can you spot it? 
You’ll fix it in the next chapter. 


public async void OpenRandomExcuseAsync() { 

工 ReadOnlyList<IStorageFile> files = await excuseFolder.GetFilesAsync(); 
excuseFile = files[random•Next(0, files.Count())]; 

await ReadExcuseAsync () ; UfaatcFilcPatcAsy^O sets iht FilcPatc *to *thc last 




modified date the e 乂 duse -Pile- j-f 以 duse 


public async Task UpdateFileDateAsync () { 1 。十山 士 it io 3 |Vs Br ， Bs^t ^tihod that yb 

if (excus^TTe != null) { ^llcd by amrth 饮 乎 method, so it rtt^s a Task- 

BasicProperties basicProperties = await excuseFile.GetBasicPropertiesAsync(); 
FileDate 二 basicProperties.DateModified.ToString(); 


else 

FileDate = "(no file loaded) 
OnPropertyChanged("FileDate"); 


The IStorageFile.GetBasicPropertiesAsync() 
method returns a BasicProperties object with read¬ 
only DateModif ied and Size properties that contain 
the modified date and size of the file. 


public async void SaveCurrentExcuseAsync() { 

if (CurrentExcuse == null) { 

await new MessageDialog("No excuse loaded").ShowAsync(); 
return; 

} 

if (String •工 sNullOrEmpty(CurrentExcuse•Description) ) { 

await new MessageDialog("Current excuse does not have a description").ShowAsync(); 
return; 


if (excuseFile 
excuseFile 


: null) 

await excuseFolder.CreateFileAsync(CurrentExcuse.Description 
CreationCollisionOption.ReplaceExisting); 


• xml ", 


await WriteExcuseAsync(); 


public async Task ReadExcuseAsync() 
// You 1 11 write this method 


public async Task WriteExcuseAsync() 
// You 1 11 write this method 


The SavcCum^iE^duscAsy^tO mcihod -fivs-t 

(Meeks \( -the e^duse is m\\ o\r 

it has erwpiy desdv-ip-tio^ displays a 
v/W ， message. 1 ( -then's a valid i-t 

dalls -fco wvi'tc "the c^usc. 

I*P y\o c^dusc -Pile yti, i-t tails ihc 

•Polde/s Cv-ca-tcFilcAsy^dO method {p ercaic it 


public async void SaveCurrentExcuseAsAsync() 
// You 1 11 write this method 




Flip the page to finish porting the app 


you are here 
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update that app bar 


Add the code-behmd for the page 


This is all the code-behind you need. The event handlers for the buttons just call 
methods in the ExcuseManager. This is a benefit of separating the concerns about 
managing excuses from the concerns about displaying the user interface. Your user 
interface code tends to be very simple, because the other classes do most of the work. 




The Random Excuse and Save buttons only work if the user selected a folder, so the 
Folder button's event handler method uses the ChooseNewFolderAsync () method's 
return value. If it returns true, it enables the Random Excuse and Save buttons. 



@ 


@ 


@ 

@ 

New Excuse 

Fofder 

Random Excuse 

Open 

Save 

Save as... 


private void OpenButtonClick(object sender, RoutedEventArgs e) { 

excuseManager.OpenExcuseAsync(); 

} 

private void SaveButtonClick(object sender, RoutedEventArgs e) { 

excuseManager.SaveCurrentExcuseAsync(); 

private void NewExcuseButtonClick(obj ect sender, RoutedEventArgs e) { 
excuseManager.NewExcuseAsync(); 

} 

private void SaveAsButtonClick(object sender, RoutedEventArgs e) { 
excuseManager.SaveCurrentExcuseAsAsync(); 

} 

private void SetToCurrentTimeClick(object sender, RoutedEventArgs e) { 
excuseManager.SetToCurrentTime(); 

} 

private void RandomExcuseButtonClick(object sender, RoutedEventArgs e) { 

excuseManager.OpenRandomExcuseAsync(); 

} 

private async void FolderButtonClick(object sender, RoutedEventArgs e) { 

bool folderChosen = await excuseManager.ChooseNewFolderAsync(); 
if (folderChosen) { 

saveButton • 工 sEnabled = true; 
randomButton • 工 sEnabled = true; 



564 


Chapter 11 


參 


考 






async await and data contract serialization 



Finish the Excuse and ExcuseManager 

classes for Brian’s new XAML Excuse Manager. 



Build the Excuse Class. 

It needs a data contract with the http : / / www. headfirst labs • com/ 
ExcuseManager namespace and three data members. The first two data members 
are the Description and Results automatic string properties. The third is 
a DateTime field called lastUsed that’s the backing field for a string property 
called LastUsed (it’s modified in the ExcuseManager . SetToCurrentTime () 
method). 

The Excuse class uses a special value, DateTime . MinValue, as the default 
value for the lastUsed field. This is the earliest date that can be stored in a 
DateTime variable, and the Excuse class uses it for an excuse without a date set. 
The LastUsed get accessor returns lastUsed. ToString () if a date is set, or 
String. Empty if it’s set to MinValue. 

The LastUsed set accessor uses this code to convert the string value to a date: 
DateTime d; 

bool datelsValid = DateTime•TryParse(value, out d); 
lastUsed = d; 


The TryParse () method returns true if the date was valid, false otherwise. 
If the user entered an invalid date, the method sets the DateWarning read-only 
string property to "Invalid date : n followed by the invalid value. This will 
get displayed in a red TextBlock to give the user a warning that an invalid date was 
entered. Don’t forget to fire a PropertyChanged event to let the page know that 
DateWarning was updated. 


This method opens a stream and serializes the current excuse to the excuse 
file managed by the IStorageFile currently stored in the excuseFile 
field. Then it displays a message that the excuse was written correctly, and calls 
UpdateFileDateAsync () to update the FileDate property. 


This method opens a stream and deserializes a new Excuse object from the 
excuse file managed by excuseFile. It fires a PropertyChanged event 
to let the page know that the CurrentExcuse was updated, then calls 
the UpdateFileDateAsync () method. You’ll also need to implement 
INotif yPropertyChanged and add the OnPropertyChanged () method. 


o Implement the ExcuseManager. WriteExcuseAsync () method. 


❺ Implement the ExcuseManager. ReadExcuseAsync () method. 


INotifyPropertyChanged | 

PropertyChanged event 

l 


Excuse 

Description 

Results 

LastUsed 

DateWarning 



INotifyPropertyChanged | 

PropertyChanged event 

l 


ExcuseManager 

CurrentExcuse 

FileDate 

NewExcuseAsync() 

SetToCurrentTime() 

ChooseNewFolderAsync() 

OpenExcuseAsync() 

OpenRandomExcuseAsync() 

SaveCurrentExcuseAsync() 

UpdateFileDateAsync() 

SaveCurrentExcuseAsAsync() 

WriteExcuseAsync() 

ReadExcuseAsync() 



Implement the ExcuseManager. SaveCurrentExcuseAsAsync () method. 

This method displays a FileSavePicker to let the user choose an XML file to save. If 
the user chooses one, it calls the WriteExcuseAsync () method to save the file. 


you are here ► 
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exercise solution 


Here are the methods that you needed to add to the ExcuseManager 
class. Make sure the class extends iNotif yPropertyChanged. 


public async Task ReadExcuseAsync() { 

using ( 工 RandomAccessStream stream = 

await excuseFile.OpenAsync(FileAccessMode.Read)) 
using (Stream inputStream = stream.AsStreamForRead()) { 

DataContractSerializer serializer = new DataContractSerializer(typeof(Excuse)); 
CurrentExcuse = serializer.ReadObject(inputStream) as Excuse; 




§OL}itipH 


await new MessageDialog("Excuse read from 
OnPropertyChanged("CurrentExcuse"); 
await UpdateFileDateAsync(); 


public async Task WriteExcuseAsync() { 

using ( 工 RandomAccessStream stream = 


+ excuseFile.Name).ShowAsync(); 

The mcihods -to \rcad v/vi-tc 


objc^is av-c vcv-y similav- -to -the 
methods \ y \ 七 he ^uy Scv-ialiicv. 


await excuseFile.OpenAsync(FileAccessMode.ReadWrite)) 
using (Stream outputStream = stream.AsStreamForWrite()) { 

DataContractSerializer serializer = new DataContractSerializer(typeof(Excuse)); 
serializer.WriteObj ect(outputStrearn f CurrentExcuse); 

} 

await new MessageDialog("Excuse written to " + excuseFile.Name).ShowAsync(); 
await UpdateFileDateAsync(); 


public async void SaveCurrentExcuseAsAsync() { 

FileSavePicker picker = new FileSavePicker { 

SuggestedStartLocation = PickerLocationld•DocumentsLibrary, 
SuggestedFileName = CurrentExcuse.Description, 
CommitButtonText = "Save Excuse File" 


picker . FileTypeChoices . Add ( "XML File’，，new List<string> () { " . xml" }); 

工 StorageFile newExcuseFile = await picker.PickSaveFileAsync(); 


if (newExcuseFile != null) { 

excuseFile = newExcuseFile; 
await WriteExcuseAsync(); 


Tk SavcCu^e^^useAsAsY^O 
a P»tkcr and saves -tKc ^ 

\i Picked. I*t updates i\\t c%tuscnlc to 
k Wk oUbev/ 仏 tU; 7 'aved (so 

七 he Save butlo" saves *to tK'»s ^ 


public event PropertyChangedEventHandler PropertyChanged; HeyVs "the ^ovmal Code bo -five 

private void OnPropertyChanged (string propertyName) { "the Pvopcv*tyCi f >3^3 c ^ CVCht- 

PropertyChangedEventHandler propertyChangedEvent = PropertyChanged; 
if (propertyChangedEvent != null) { 

propertyChangedEvent(this, new PropertyChangedEventArgs(propertyName)); 
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async await and data contract serialization 


Here’s the new Excuse class. It’s got a data contract that includes the Description 
and Results properties and the lastused backing field for the LastUsed property. 


using System.ComponentModel; 
using System.Runtime.Serialization; 

[DataContract(Namespace="http :// www.headfirstlabs.com/ExcuseManager")] 
class Excuse : 工 NotifyPropertyChanged { 

public string DateWarning { get; set; } 

[DataMember] 

public string Description { get; set; } 


[DataMember] 

public string Results { get; set; 


DateTime.MinValue 


[DataMember] 

private DateTime lastUsed 
public string LastUsed { 
get { 

if (lastUsed != DateTime.MinValue) 
return lastUsed.ToString(); 

else 

return String.Empty; 

} 

set { 



CPaia/l/lcmbc\r3 atbribu 七 e 
-to *thc las*tUscd -f ield causes 

七 ha 七 -field *to yt v/v*i*ttch a^d v-cad 
duv'm^ scv-ializ-atio^ ov* dcscv-'ializ-a-t'io^. 


DateTime d = DateTime.MinValue; 
bool datelsValid = DateTime•TryParse(value, out d); 
lastused = d; 


l*f 七 he usc\r a valid da-tc value ； 

Da 七 eTime.TVyPa\rseO will i-t io a 

DaicTimc ar>d v-ciuv-^ iv-uc. I-P ii will 
leave 七 he value d sci -to Da-tcTimc M*m\/aluc. 


if (!String • 工 sNullOrEmpty(value) & & !datelsValid) { 
DateWarning = "Invalid date : " + value; 


else 

DateWarning = String.Empty; 
OnPropertyChanged("DateWarning") 


^ lastUscd is set io DateTime. 
M'ml/aluc, the DatclVav-hihg -field is sei 
^ a -to display -to the usev. 


public event PropertyChangedEventHandler PropertyChanged; 


private void OnPropertyChanged(string propertyName) { 

PropertyChangedEventHandler propertyChangedEvent = PropertyChanged; 
if (propertyChangedEvent != null) { 

propertyChangedEvent(this, new PropertyChangedEventArgs(propertyName)); 



This is the same code to fire a PropertyChanged event from earlier in the 
chapter. But if you copied and pasted it into your Excuse or ExcuseManager 
class and forgot to add : 工 Notif yPropertyChanged to the class declaration, 
the controls on the page won’t set up data binding. That means your objects 
will fire their PropertyChanged events, but without page controls listening 
for those events, the data binding will not work. That can be a frustrating bug! 


you are here ► 
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Programmers aren’t meant to be firefighters. 

You’ve worked your tail off, waded through technical manuals and a few engaging 
Head First books, and you’ve reached the pinnacle of your profession. But you’re 
still getting panicked phone calls in the middle of the night from work because your 
program crashes, or doesn’t behave like it’s supposed to. Nothing pulls you 
out of the programming groove like having to fix a strange bug...but with exception 
handling, you can write code to deal with problems that come up. Better yet, you 
can even react to those problems, and keep things running. 


this is a new chapter 
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mo, programs ， mo ， prob/ems 


Priaw needs his excuses to be mobile 

Brian recently got reassigned to the international division. Now 
he flies all over the world. But he still needs to keep track of his 
excuses, so he installed the Excuse Manager app on his laptop and 
takes it with him everywhere. 



r. 

ol 

aUavs lookmoy ^ 
扣 -to yt 

out 如 oA. 


VO^E^S BOEING T^DAY. I WANT TO 
&0 SCUBA DIVINE. TIME TO FIEB UP 
THE 6 X 6 USB MAMA 夕 ER. 


Bmiah s jo-t -the 
Excuse /W^hagcv- 

v*Uhhih0 oh his laptop. 




Put the program isn't working! 

Brian chose a brand new, empty folder and 
clicked the Random Excuse button, and got 
a pretty nasty-looking error. What gives? 



have bw a 




a 




Microsoft Visual Studio Express 2012 for Windows 8 


! 


An exception of type 1 System.ArgumentException 1 occurred in mscorlib.dll but was 
not handled in user code 

Additional information:: Value does not fall within the expected range. 

If there is a handler forthis exception, the program may be safely continued. 


v 


Break when this exception type is user-unhandled 

Open Exception Settings 


Break 


Continue 


ignore 
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exception handling 


c^^rpen your pencil 


Here’s another example of some broken code. There are five different exceptions 
that this code throws, and the error messages are shown on the right. It’s your 
job to match the line of code that has a problem with the exception that line 
generates. Read the exception messages for a good hint. 


public static void BeeProcessor () { 

object myBee = new HoneyBee(36•5, "Zippo"); 
float howMuchHoney = (float)myBee; 

HoneyBee anotherBee = new HoneyBee(12•5, "Buzzy"); 
double beeName = double.Parse(anotherBee.MyName); 


CalU 5 double 

a double value, l.kc 

It. Ac s second 

para-eiev se-b 


double totalHoney = 36.5 + 12.5; 
string beesWeCanFeed =""; 

for (int i = 1; i < (int) totalHoney; i++) { 

beesWeCanFeed += i.ToString (); 

} 

float f = 

float.Parse(beesWeCanFeed); 


int drones = 4; 
int queens = 0; 
int dronesPerQueen = drones 

anotherBee = null; 
if (dronesPerQueen < 10) { 

anotherBee.DoMyJob(); 


queens; 


An unhandled exception of typ e 1 System.0verfIowException 1 occurred in mscorlib.dll 
Additional information^ Value was either too large or too small for a Single. 


An unhandled exception of ty p e 1 System .Null Ref eren c eExc epti o n 1 occurred in 
B eeProc essing System, exe 


Additional information: Object reference not set to an instance of an object 




An unhandled exception of typ e 1 System.InvaIidCastException 1 occurred in 
B eeProc essing System, exe 

Additional information: Specified cast is not valid. 


An unhandled exception of type 1 System.DivideByZeroException 1 occurred in 
B eeP roc essing System, exe 


Additional informations Attempted to divide by zero. 


④ 


An unhandled exception of typ e 'System.FormatException 1 occurred in mscorlib.dll 
Additional information: Input string was not in a correct format. 
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breaking the rules 


c^^rpen your pencil 


Your job was to match the line of code that has a 
problem with the exception that line 

—_ ，如 CLlUan。do 

object myBee = new HoneyBee (36 • 5, "Zippo" ); 匕私七 so »"t *t^v-OY/s Bv\ l^validCssxt^C^'tio^ 

float howMuchHoney = (float)myBee; 


e u ia l I iaD a 

a M - WU — 。叫 

WoY\Cf>tt < 



An unhandled exception of type 'System.InvalidCastEKception' occurred in 
B eeP roc easing System, exe 


Additional information: Specified cast is not valid. 




HoneyBee anotherBee = new HoneyBee(12•5, "Buzzy") 
double beeName = double.Parse(anotherBee.MyName); 



丁 he Rav-scO method you 

9 ,vc ^ a sVmg ih a ^-taih 

o\rmn3-i. Buzz.y ish ； *t 3 s-tv-ihg 
it khows how -fco ^ohVcV"*t "to S 
gmbcir. Thai s why \i thv-ows a 
Poir 匕吓七 ioh. 


An unhandled exception of type 'System-FarmatException 1 occurred in mscorlib.dll 


Additional information: Input string was not: in a correct format. 




double totalHoney = 36.5 + 12.5; 
string beesWeCanFeed =""; 
for (int i = 1; i < (int) totalHoney; 
beesWeCanFeed + 二 i.ToString(); 

} 

float f = float.Parse(beesWeCanFeed); 


U loo ? W.II a called 

^| 0 at Will Ovc^lov/t^cftioy.. 


i++) 


An unhandled exception of type 'System.OverflowException' occurred in mscorlib.dll 
Additional information: Value was either too large or too small for a Single. 


You’d never actually get all these exceptions 
in a row — the program would throw the first 
exception and then stop. You’d only get to 
the second exception if you fixed the first. 
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int 

drones = 

= 4; 



int 

queens = 

= 0; 



int 

dronesPerQueen = 

=drones / 

/ queens; 


It's \rcally easy -to -thv-ow a 
PividcByZc\roE^cj>-tioh. Just 
divide Bv\y humbe\r by z^v-o. 


An unhandled exception of type 1 System.DivideByZeroException 1 occurred in 
B eeProc es-sing System, exe 

Additional information: Attempted to divide by zero. 


④ 


Pividm^ dr^y m 七 efr by 'LCro always *tKvoy/s kmd of 

you do^*t kr^oy/ value J you 

ca^ pvcvc^*t \i >st by cMtck\^ value *to make su^rc it s 
的。七 zjCVo bc-fovc you divide i"t •… "to dv-ov^s. 



anotherBee = null; 
if (dronesPerQueen < 10) { 

anotherBee.DoMyJob(); 



Srttmj -the a^othcv-Bcc v-c-Pcv-c^dc variable c<\ual -fco 
null tel Is C 养 that i*t doesy / 七 pom-t bo So 

ms-tcad o( -fco By\ object, it pomts -to 

Thv-owmj a NulIRcTcv-c^cE^cp-tio^ is C 养 ’s way of 
•tdlmj you 七 1^ 七 -thcv-c^s object whose DoMyJobO 

rwrthod 匕扣 be called. 


An unhandled exception of ty p e 1 System .Null Ref eren c eExc epti o n 1 occurred in 
B eeProc easing System ■ exe 

Additional information: Object reference not set to an instance of an object. 


That DivideByZero error didn’t have to happen. You can see just by looking 
at the code that there’s something wrong. The same goes for the other 
exceptions. These problems were preventable — and the more you know 
about exceptions, the better you’ll be at keeping your code from crashing. 
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mmm fudge 


Whew your program throws aw exception, 
•NET generates an Exception object. 


You’ve been looking at .NET’S way of telling you something went 
wrong in your program: an exception. In .NET, when an exception 
occurs, an object is created to represent the problem. It’s called- 
surprise here — Exception. 








-no 


For example, suppose you have an array with four items. Then, you try 
to access the 16th item (index 15, since we’re zero-based here): 

This Code is 

int[] anArray = {3, 4, 1, 11}; obvious, y -to 

■ . __ n _ r - _ - ^ausc Problems. 

int aValue = anArray[15]; 


has 




a person or thing that is 
excluded from a general 
statement or does not 
follow a rule. While Jim 
usually hates peanut butter, he 
观 de an exception for Ken's 
peanut butter fudge. 


As sooh as you\r pvogv-arw v-uhs 

釙 cxdcptioh, it gchcv-alcs 

objc^ wiih all the data ° e PWon 

^DOU-t 


When the IDE breaks because of an exception, you can see the 
details of the exception by adding $ exception to the Watch 
window. It always shows up in the Locals window too, which is a 
lot like the Watch window but only shows current local variables. 


the pv-oblcm. 


TV^C object V^as a 

a V,st all 呼 ^ 

y/cvc wade c 

sU 一从 a 七 caused tV^c 



Watch 1 


0 Sexceptiorii 



Name 
B 

田 # [System. I n d ekO utOfRa n g eExcepti o n] 
© Data 
Jk HelpLink 
M HResult 

InnerException 
Message 
P Source 
Jfr StackTrace 
Jh TargetSite 
Static members 
田 • Non-Public members 


田 



田 


Value 


{"Index was outside the bounds of the array. 


{"Index was outside the bounds of the array,"] 

{System .Coll ecti ons.Li stD ictionaryl nternal} 
null 

-Z1462BB0S0 
null 

"Index was outside the bounds of the array." 

"Co nsol eAp plicationl" 

■■ at ConsDleApplication1.Program.Main[Strinc 
{Void Main[System.String[])} 


▲ 


▼ 


Locals Watch 1 


.NET goes to the trouble of creating an object because it wants to give you all 
the information about what caused the exception. You may have code to fix, 
or you may just need to make some changes to how you handle a particular 
situation in your program. 

In this case, an IndexOutOf RangeException indicates you have a bug: 
you’re trying to access an index in the array that’s out of range. You’ve also got 
information about exactly where in the code the problem occurred, making it 
easier to track down (even if you’ve got thousands of lines of code). 


574 Chapter 12 







exception handling 



Dumb Quest! 


ons 


Why are there so many kinds of exceptions? 

A! There are all sorts of ways that you can write code that 
C# simply doesn’t know how to deal with. It would be difficult 
to troubleshoot your problems if your program simply gave a 
generic error message (“A problem occurred at line 37"). It's a 
lot easier to track down and fix problems in your code when you 
know specifically what kind of error occurred. 

So what is an exception, really? 

A! It’s an object that .NET creates when there’s a problem. 
You can specifically generate exceptions in your code, too (more 
about that in a minute). 

Wait, what? It’s an object? 

A: Yes, an exception is an object. The properties in the 
object tell you information about the exception. For example, 
it’s got a Message property that has a useful string like 
“Specified cast was invalid” or “Value was either too large or too 
small for a Single", which is what the IDE used to populate the 
$exception watch. The reason that .NET generates it is 
to give you as much information as it can about exactly what 
was going on when it executed the statement that threw the 
exception. 

OK, I still don’t get it. Sorry. Why are there so many 
different kinds of exceptions, again? 

A! Because there are so many ways that your code can act 
in unexpected ways. There are a lot of situations that will cause 
your code to simply crash. It would be really hard to troubleshoot 
the problems if you didn’t know why the crash happened. 

By throwing different kinds of exceptions under different 
circumstances, .NET is giving you a lot of really valuable 
information to help you track down and correct the problem. 

So exceptions are there to help me, not just cause a 
pain in my butt? 

A: Yes! Exceptions are all about helping you expect the 
unexpected. A lot of people get frustrated when they see code 
throw an exception. But if you think about an exception as 


■NET’S way of helping you track down and debug your program, it 
really helps out when you’re trying to track down what’s causing 
the code to bomb out. 

So when my code throws an exception, it’s not 
necessarily because I did something wrong? 

A! Exactly. Sometimes your data’s different than you 
expected it to be—like you’ve got a method that’s dealing with 
an array that’s a lot longer or shorter than you anticipated when 
you first wrote it. And don’t forget that human beings are using 
your program, and they almost always act in an unpredictable 
way. Exceptions are .NET’S way to help you handle those 
unexpected situations so that your code still runs smoothly and 
doesn’t simply crash or give a cryptic, useless error message. 

Once I knew what I was looking for, it was pretty clear 
that the code on the previous page was going to crash. Are 
all exceptions easy to spot? 

No. Unfortunately, there will be times when your code 
will have problems, and it’ll be really hard to figure out what’s 
causing them just by looking at it. That’s why the IDE has a 
debugger— to help you get the bugs out by letting you pause 
your program, execute it statement by statement, and inspect 
the value of each individual variable and field as you go. That 
makes it a lot easier for you to figure out where your code is 
acting in a way that’s different from how you expect it to act. 
That’s when you have the best chance of finding and fixing the 
exceptions—or, even better, preventing them in the first place. 


Exceptions are all atout 
kelping you linJ and lix 
situations wkere your 
code tekaves in ways 


you didn’t expect* 
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P files.Countn 

0 random.NeKtfO, filesXountO) 


Name 


Value 




nobody expects the ... 


Priaw's code did something unexpected 

When Brian wrote his Excuse Manager, he never expected the 
user to try to pull a random excuse out of an empty directory. 



o The problem happened when Brian pointed his Excuse Manager program at an 
empty folder on his laptop and clicked the Random Excuse button. Let’s take a 
look at it and see if we can figure out what went wrong. Here’s the unhandled 
exception window that popped up when he ran the program outside the IDE: 


Microsoft Visual Studio Express 2012 for Windows 8 



! 


An exception of type 'System.ArgumentE^ception 1 occurred in mscorlib.dll but was 
not handled in user code 

Additional information: Value does not fall within the expected range. 

If there is a handler for this exception, the program may be safely continued. 


v 


@ Break when this exception type is user-unhandled 

Open Exception Settings 


Break 


Continue 


Ignore 


this! 




❺ OK, that’s a good starting point. It’s telling us that there’s some value that 

doesn’t fall inside some range. Clicking the Break button drops the IDE back 
into the debugger, with the execution halted on a specific line of code: 

public async void OpenRandomExcuseAsync() 

{ 

工 ReadOnlyList<IStorageFile> files = await excuseFolder.GetFilesAsync() 


excuseFile = files[random•Next(0, files.Count () 


await ReadExcuseAsync(); 


❺ Let’s use the Watch window to track down the problem. Add a watch for files . Count () . Looks 
like that returns 0. Try adding a watch for random. Next ( 0 , files . Count () ) . That returns 
0, too. So add a watch for files [ random. Next (0 , files . Count ())]. 


files[random.Nect(0, filles.CountQJ] threw an exception of type System,ArqumentException 


fles[ ra nd om n Next(0, files. CountO)] 


c■_• ■: :■ 
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You tBv\ dal I methods and use \ y \ y/mdov/. 

ov\t o( -those *tWoy/s By\ youll sec 

\ y \ lVa*tdh y/*mdoy/ boo- 




























exception handling 


So what happened? It turns out that calling GetFilesAsync () from an I Storage Folder object 
returns an 工 ReadOnlyList<IStorageFile> collection. And like other collections that you’ve used, 
if you try to access an element that doesn’t exist, it will throw an exception. Try to get the Oth element of 
an empty collection and your program will throw a System. ArgumentException, with the message, 
“Value does not fall within the expected range.” 

Luckily, there’s an easy fix. Just check to see if the collection has items before getting a file: 


public async void OpenRandomExcuseAsync() 


工 ReadOnlyList<IStorageFile> files = await excuseFolder.GetFilesAsync (); 

if (files.Count() == 0) { 

await new MessageDialog("The current excuse folder is empty. n ).ShowAsync(); 
return; Ok gy dhcdkmg (or c^dusc 

} /files \y\ the -Poldev* before 

excuseFile = files [random• Next (0, files . Count () ) ] ; 、 ^ the E'/.dusc" 

await ReadExcuseAsyncO; ItjeH Je tL 

■tivrovm — display d 
hclf-pul dialog boo. 



夕工 &BJ IT. 6X6BPTI^MS ALWAYS 

BAD. S^MBTIMBS TH5Y IDENTIFY BU^S ； BUT A 
U>J O? TH5 TIMB T ㈣ , R5 JUST TBUUIM^ MB THAT 
S^MBTHIN^ HAPPBMBD THAT WAS DIFFBR6NT 

WHAT I BXP66TBD. 




That’s right. Exceptions are a really useful tool 
that you can use to find places where your code 
acts in ways you don’t expect. 

A lot of programmers get frustrated the first time they see an 
exception. But exceptions are really useful, and you can use them to 
your advantage. When you see an exception, it’s giving you a lot of 
clues to help you figure out when your code is reacting to a situation 
that you didn’t anticipate. And that’s good for you: it lets you know 
about a new scenario that your program has to handle, and it gives 
you an opportunity to do something about it. 
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the exception family tree 


All exception objects inherit from Exception 

.NET has lots of different exceptions it may need to report. Since many of these 
have a lot of similar features, inheritance comes into play. .NET defines a base 
class, called Exception, that all specific exceptions types inherit from. 

The Exception class has a couple of useful members. The Message property 
stores an easy-to-read message about what went wrong. And StackTrace tells 
you what code was being executed when the exception occurred, and what led up 
to the exception. (There are others, too, but we’ll use those first.) 


ToS-tv'm^O ^traits d summav-y 

<Jc all o? m 

-fields ar>d rt m 


Exception 


Message 

StackTrace 


GetBaseExceptionf) 

ToStringf) 







IndexOutOfRange 


FormatException 


OverflowException 


DivideByZero 

Exception 

Exception 


Message 

StackTrace 


Message 

StackTrace 


Message 




Message 

StackTrace 

StackTrace 


GetBaseExceptionf) 

ToStringf) 


GetBaseExceptionf) 

ToStringf) 


GetBaseExceptionf) 

ToStringf) 




GetBaseExceptionf) 

ToStringf) 


\{!s v-cally useful 
^'ivcs us so 七 Y? es d 

because 

说⑽七 C 叫 W 七 Wr 广 m 

•m a diWcv-cy\*t situation, you . 
ta” lcav-y\ a lot abou 七七卜 
unc%\>ct*tcd a 出七 h 七 ’s ^ausm^ 
caption just by lookm^ at 

or\t >was 
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The debugger helps you track down and 
prevent exceptions m your code 


丁 h "toolb^V" ohly sKov/s up 

whch you \rc dcbuggihg youv- 
ih the IDE. So you ； ll Ii3vc -to V"Uh B 
pv*og\ram ih o\rde\r "fco see this. 


Before you can add exception handling to your program, you need to know which 
statements in your program are throwing the exception. That’s where the debugger 
that’s built into the IDE can be really helpful. You’ve been using the debugger 
throughout the book, but now let’s take a few minutes and really dig into it. When 



you run the debugger, the IDE pops up a toolbar with some really useful buttons. 


Click the □ icon on the Debug toolbar and choose “Add or Remove Buttons” to drill 
down into the various debugging commands that are available. 


You vc \)ttY\ us'm^ *thc Co^tmuc, Bv^cak f[\\, By\A 

S*top Pcbu^mj bu*t*to^s *tWou#ou*t the book *to 
\rcsumc, Br\d youv p\royams. 


© 


k C ? 吒 


Add or Remove Buttons ， 


Show Ncx.*t S*ta 七 emerrt moves -the IDE’s edi-fcov- *bo 
七 he s-fcatcrwc^-t 七 ha 七 will be exe 乙 uted. 


You vc used -these *to step tliv-oujh youv fv-oyams. 
Use Step Ovcv- *to skip ovcv method td\\s. Step 
|^*to moves *to the -f iv-st ⑶七 a method 

己 all, a 灼 d Step Out -finishes -the tuvve^t method 

by\A s*tops a-ftev* the that tailed it- 


1( you enable the Hex. bu-t-to^, you cav\ 

use it -to "tum hexadecimal mode ov\ av\d 

o-P-f. iVhch its oy\, you 

o\r hovcv- ovcv a v/holc ^umbev- variable like 

•mt, ov- byte, its displayed m he 乂 . 


0 © 
□ ^ 
□ ^ 

□ ^ 

□ C? 



The w Rc-Pv-csh iVmdows aff W 
butto 的 is used -fov JavaScript 

affs. Its disabled -fov C 养 apps. 



Continue 
Break All 
Stop Debugging 
Restart 

Refresh Windows app 
Show Ned Statement 
Step Into 
Step Over 
Step Out 
Hex 

Show Threads in Source 

Windows WOh i wwaCM dbou^t 

^ x treads ih this book, but i-f 

Customize … ^ 0 , 

ypu \rc dubious see Ic+tovcv- 

Reset Toolbar 


祙午 m the appehdix. 


value 0x3afb83d9 




HevVs -the same value 
displayed m hex noodle or\ 一 

the Irf 七 and dedinrtdl 你 ode 

oy\ 七 he \ri^ht 




4 value 989561817 
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you don’t know where that watch has been 


UsGthc IPE's debugger to ferret out exactly 
what wewt wrong m the Excuse Manager 


Let’s use the debugger to take a closer look at the problem that we ran 
into in the Excuse Manager. You’ve probably been using the debugger 
a lot over the last few chapters, but we’ll go through it step by step 
anyway to make sure we don’t leave out any details. 

O ADD A BEBAKP^INT lO 丁 H5 ISANO 夕 M BUTTONS 5V5NT HANDU512. j 

You’ve got a starting point — the exception happens when the Random Excuse button is clicked after 
an empty folder is selected. So open up the code-behind for the button and use Debug—Toggle 
Breakpoint (F9) to add a breakpoint to the method. Start debugging the app, choose an empty 
folder, then click the Random button to make your program break at the breakpoint: 






\- private void RandonExcuseButton<Ilick:(object sender^ Routed Eve ntArgs e) 


o 


卜 kc useMlanager.OpenRandomExcuseAsync() 


} 


STEP INT^> TH6 OP6Nl^aNt>OMB>ccuseAsyNc() METHOD- 

Use the Step Into command (using either the toolbar or the FI 1 key) to debug into the method. 
Then use Step Over (F10) to step through the method line by line. Since you selected an empty 
folder, you should see the program show the MessageDialog () and then exit the method. 

IReadCnlyList<IStorageFile> files = await excuseFolder.G.etFilesAsync()i 
if (files ■ Count 0 = 0) 

{ 

C- ^wait new Messa geDia I,og("The current excuse folde r is empty . »ShowAsync() 

return; 

} 

excuse File = f lies [ random, INext f i le s. Co u nt () ) ] j 



Notice how 
the debuggev- 
Wcli'ts -Po\r the 
/WcssagcDialog 
cveh -though its 
乙 ailed with -the 

await keyword. 


Now select a folder with excuses in it, click the Random button again, and step into the 
method again. This time, your code will skip past the if block and move on to the next line. 


h public async void OpenRandomExcuseAsyn c() 

{ 

IReadOnIy^ist<IStorageFile> files = await exc useFoIde r. GetFilesAsync ( )j 
if (files.Count(J == 0) 

{ 

await new ' lessageDialog ( J, The current excuse folder is empty. ”) ^ShdwAsyTic()i 
return j 

O lexcuseFile = files [random* Mext% files. Count ()) ]; 

await Re ad Exc u seAsyn c ( )j 
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❺ 

^/o\a y/3r\*t 


USB TH5 VJAT6H WINDOW lO STA12T 125P12^DU6IN^ TH5 

You’ve already seen how handy the Watch window is. Now we’ll use it to reproduce the exception. 
Stop the program, delete the old breakpoint, and put a breakpoint on the second line of the 


•to Weak o”-^OpenRandomExcuseAsync() method. Start the program, choose an empty folder, then click the 


七 he sctor\d 
I'mc because 
七七 、七 he 
I me 

a^tesscs 
-files object. 


Random Excuse button. When the debugger breaks in the method, select files . Count (), right-click 
on it, and choose Add Watch to add a watch to the Watch window: 


Name 

# files.CountO 


Value 

0 


O ADD AN^THBE WATCH lO START T12A6KIN^ D^>WN THE PE^>BL5M. 

Debugging is a little like performing a forensic crime scene investigation on your program. You don’t necessarily 
know what you’re looking for until you find it, so you need to use your debugger U GSI kit” to follow 
clues and track down the culprit. Since files . Count () wasn’t the guilty party, move on to the next 
suspect: select random. Next (files . Count () ) and add it to your Watch window: 


Watch 1 


Name 


Value 


# files.CountO 0 Q 

_ random.Next[fiIes.CountQ] 0 



The Watch window has another very useful feature. It lets you change the value of variables and 
fields that it’s displaying, and it even lets you execute methods and create new objects. When you 
do, it displays its reevaluate icon Q that you can click to tell it to execute that method again, because 
sometimes running the same method twice will generate different results (like with Random). 


O ^AT6H TH5 6ULPEIT THAT THE5W BEIAN^ ^EI^INAU BXCBPTI^N. 


vj\)Cy\ you 

alv-eady 

pvoblcm by 
dddnr>^ Code *to 
thedk 七 he 

-foldcv- has -f iles, 


Here’s where debugging gets really interesting. Add one more line to the debugger — the statement that 
actually threw the exception: files [random.Next (0 A files . Count () ) ]. As soon as you type 
it in, the Watch window evaluates it.. .and that throws the exception! 


Name 

# filesXountO 
P random.Next(files..CountO) 


Value 

0 

0 




you tar\ still ^ files[random,Ned:[O r files.CountO)] 'fiIe^[random,Nest[O r files.CountO)]' threw an exception of type 'System,ArgumentException ' 


use 


七 he 


v/'mdov/ *to 
vcpv-odutc 


Click the + icon to expand the exception, and you’ll see that its Message property contains “Value 
does not fall within the expected range.” Now you know exactly what caused the problem, and why 
it happened. GetFilesAsync () returns a IReadOnlyList<IStorageFile> collection 
that has a count of 0 for an empty folder. If you try to use its indexer (files [ 0 ]), it will throw an 


ArgumentException. 


When you get an exception, you can go back and reproduce it in the 
debugger and use the Exception object to help you fix your code. 
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make a break for it 



Dumb Questi 


ons 


When I run my app in the IDE, I 
can view the exception details using the 
Watch window. But what happens if I run 
the program outside of the IDE? 

A! There’s an easy way to 
answer that question. Comment 
out the change you made the 
OpenRandomExcuseAsync() 
method to fix the problem, and then launch 
your app by choosing Start Without 
Debugging from the Debug menu. This will 
launch your app as if it were clicked from the 
Start screen. (You can also just go and click 
it from the Start screen.) Choose an empty 
folder, click the Random Excuse button, 
and...bam! Your app just disappears. 


That’s what normally happens when an 
app has an unhandled exception. (You’ll 
learn more about how to handle exceptions 
later in the chapter.) Most users don’t want 
to see a cryptic window full of method 
names and exception details. But don’t 
worry—your exception isn’t lost. Open up 
the Windows Control Panel (you can search 
for “Control Panel” from the Start screen), 
search for “event,” and view the event 
logs. Expand Windows Logs and click on 
Application. One of the Error events in 
the Application event log will contain your 
app’s exception, including a stack trace 
that shows you the line that threw the 
exception, the line that called it, the one that 
called it, etc. (that’s called the call stack). 
When you’re debugging, the stack trace 
is in the StackTrace property of the 
Exception object. 

So that’s it? When an exception 
happens outside the IDE, my program 
just stops and there’s nothing I can do 
about it? 
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A! Well, your program does stop when 
there’s an unhandled exception. But that 
doesn’t mean that all of your exceptions 
have to be unhandled! We’ll talk a lot more 
about how you can handle exceptions in your 
code. There's no reason your users ever 
have to see an unhandled exception. 

How do I know where to put a 
breakpoint? 

A: That’s a really good question, and 
there’s no one right answer. When your code 
throws an exception, it’s always a good 
idea to start with the statement that threw it. 
But usually, the problem actually happened 
earlier in the program, and the exception 
is just fallout from it. For example, the 
statement that throws a divide-by-zero error 
could be dividing values that were generated 
10 statements earlier but just haven’t been 
used yet. So there's no one good answer to 
where you should put a breakpoint, because 
every situation is different. But as long as 
you’ve got a good idea of how your code 
works, you should be able to figure out a 
good starting point. 

Can I run any method in the Watch 
window? 

Yes. Any statement that’s valid in your 
program will work inside the Watch window, 
even things that make absolutely no sense 
to run inside a Watch window. Here's an 
example. Bring up a program, start it running, 
break it, and then add this to the Watch 
window: System. Threading. 
Thread. Sleep (2000 ). That 
method causes your program to delay for 
two seconds.There's no reason you'd ever 
do that in real life, but it's interesting to see 
what happens: the IDE will block and you’ll 
get a wait cursor for two seconds while the 


method evaluates. Then, since Sleep () 
has no return value, the Watch window will 
display the value Expression has 
been evaluated and has no 
value to let you know that it didn’t return 
anything. But it did evaluate it. Not only that, 
but it displays IntelliSense pop ups to help 
you type code into the window. That’s useful 
because it shows the available properties 
and methods for objects currently in memory. 

Wait, so isn’t it possible for me 
to run something in the Watch window 
that’ll change the way my program runs? 

Yes! Not permanently, but it can 
definitely affect your program’s output. But 
even better, just hovering over fields inside 
the debugger can cause your program to 
change its behavior, because hovering 
over a property executes its get accessor. 
If you have a property that has a get 
accessor that executes a method, then 
hovering over that property will cause that 
method to execute. And if that method sets 
a value in your program, then that value will 
stay set if you run the program again. And 
that can cause some pretty unpredictable 
results inside the debugger. Programmers 
have a name for results that seem to be 
unpredictable and random: they’re called 
heisenbugs (which is a joke that makes 
sense to physicists and cats trapped in 
boxes). 


Wken you run your 
program inside tke 
IDE，an unkanctlect 
exception will cause 
it to treak as il 
it kad run into a 


treakpoint. 
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Uh oh — the code's still got problems... 

Brian was happily using his Excuse Manager when he accidentally 
chose a folder full of XML files that weren’t created by the Excuse 
Manager. Let’s see what happens when he tries to load one of them.... 



You can re-create Brian’s problem. Find one of the XML files that contains 
a serialized Excuse object. Open it up in Notepad and and add some 
invalid, non-XML text to the very beginning, right before the opening < 
character. 



Pop open the Excuse Manager in the IDE and open up the excuse. It throws an 
exception! Look at the message, then click the Break button to start investigating. 




Open up the Locals window and expand $exception (you can also enter it into 
the Watch window). Take a close look at its members to see if you can figure out 
what went wrong. 


Name 

□ gB 


Value 


MSm 


iKHir 














E) 0 [System.Runtime.Serialization.SerializationException] 
^ Data 



{"There was an error deserializing the object of type XamlExcuseManager.Excuse. The data at the root level is invalid. Line 1, position 1."} 
(Svstem.Collections.ListDictionafvInternal 


Message 
A Source 
A StackTrace 
田 A TargetSite 
田 ^ Static members 
田分 Non-Public members 
Wm this 
田 • picker 


position 1."} 

There was an error deserializing the object of type XamlExcuseManager.Excuse. The data at the root level is invalid. Line 1, position 1." 4 
System .Runtime. Serialization" 

at ^vcfpm.Rnntimp.^prialiTatinn.Xminhiprt^priflliTPr.RpaHnhiprtHanHIpFYrpntinn^rymlRpflHprnpIpnfltnr Rnnlpan vprifvOhiprtr Q. 



{XamlExcuseManager.ExcuseManager} 

{Windows.Storage.Pickers.FileOpenPicker} 


t>o you see )ajhy thb piso 多 isam rnseuj thb bxcbption? 

l>OBS IT MAKB SBNSB F^>12 THB P12^12AM TO C12ASH IF 
IT 5NC 夕 UNT5BS AN ISJVAUt> 6XCUSB XML flUB? 

CAN YOU THINK Of ANYTHING YOU CAN t>0 ABOUT THIS? 
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users are unpredictable 


O 


o 


VOAIT A SECOND. O? COU^SB THB 
PRO 妹 AM，S ^MNA 6RASH - 工 ^AVB IT A BAD 
FIUB. USERS S6RBW UP AUU TN5 TIME. ^/OU 6AM^ 
BXPB6T MBT^> DO ANYTHING ABOUT THAT-.. 

121 糾 T? 



Actually, there is something you can do about it. 

Yes, it’s true that users screw up all the time. That’s a fact of life. 
But that doesn’t mean you can’t do anything about it. There’s 
a name for programs that deal with bad data, malformed input, 
and other unexpected situations gracefully: they’re called robust 
programs. And G# gives you some really powerful exception 
handling tools to help you make your programs more robust. 
Because while you can’t control what your users do, you can make 
sure that your program doesn’t crash when they do it. 


ro-bust ， adj. 

sturdy in construction; able 
to withstand or overcome 
adverse conditions. After the 
丁_观 Narrows Bridge disaster, 
the c 滅 engineering team looked 
f ora _re robust design for the 
bridge that would replace it. 


TKc Bmav-yFovrwa-t-tcv- dlass W\W 
also 七 Woy/ a 

i-f you 51VC i*t a -file 七 ha 七 does〆 七 _ 
dorrtam c%ad*tly scv'ial'iz^d 

objedt I Vs move f’midky *tKav> 
Pa*t3Coy> 


■> 



Serializers will throw an exception 
if there’s anything at all wrong with 
a serialized file. 

It’s easy to get the Excuse Manager to 
throw a Serial! za tionException — 
just feed it any file that’s not a serialized Excuse 
object When you try to deserialize an object from a file, 

Da taCon trac tSeri al i zer expects the file to contain a 
serialized object that matches the contract of the class that 
it’s trying to read. If the file contains anything else, almost 
anything at all, then the ReadObject () method will throw 
a Seriali za ti onExcepti on. 
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Handle exceptions with try and catch 


In G#, you can basically say, “Try this code, and if an exception occurs, 
catch it with this other bit of code.” The part of the code you’re trying is the 
try block, and the part where you deal with exceptions is called the catch 
block. In the catch block, you can do things like print a friendly error 
message instead of letting your program come to a screeching halt: 

public async Task ReadExcuseAsync() { 
try 


TW«s *»s 

Wodk. You 

stavt 
七卜 

dode …七 


FU i^tcodt that thvow 

J inside -the -t,y blo,k. 

^ as usual, a,d the 

i h i he bUk 

y bid 扣 

iresi of ihe iry 

oC ^ WOh ^ cxc^u-tcd. 

using (IRandomAccessStream stream = 

await excuseFile. OpenAsync (FileAccessMode. Read)) 
using (Stream inputStream = stream. AsStreamForRead ()) { 
DataContractSerializer serializer 

=new DataContractSerializer(typeof(Excuse)); 
CurrentExcuse = serializer.ReadObject(inputStream) as Excuse; 

} Youll \rMo3hiwth<! dodc hcv-c bemuse we 

suirvouhded the method with this tv-y blodk. 
await new MessageDialog("Excuse read from " 

+ excuseFile.Name).ShowAsync(); 
OnPropertyChanged( n CurrentExcuse"); 


await UpdateFileDateAsync() 


catch (SerializationException) 


丁 he keywovd rwcahS -that the 

广 blod< im^cdia-tcly -Polloy/ihg it dohtaihs 

么 ah c^cp-tioh ha^dlev-. 


new MessageDialog("Unable to read 


This is the simplest kind of exception handling: stop the 
program, write out the exception message, and keep 
running. Notice how there’s no await keyword when 
showing the MessageDialog? That’s because you 

can’t await in the body of a catch clause. Luckily, 
you can still call the ShowAsync () method, but it will 
block until the user dismisses the dialog. 


+ excuseFile.Name).ShowAsync(); 

W\\cy\ is thv-oy/h, the 

jumps io the uicM 
ahd siaris exedutmg the taic\\ blodk. 





If throwing an exception makes your code 
automatically jump to the catch block, what 
happens to the objects and data you were 
working with before the exception happened? 
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risky business 

What happens when a method you wawt to call is risky? 


Users are unpredictable. They feed all sorts of weird data into your 
program, and click on things in ways you never expected. And 
that’s just fine, because you can handle unexpected input with good 
exception handling. 


① Let’s say your user is 
using your code, and 
gives it some input 
that it didn’t expect. 


oserg/ves 


VpV our 



some input 


user 


a class 
you wrote 


⑧ That method does 
something risky, 
something that might 


not work at runtime. 



Ruh-tirwc w just 'while youv 

Some people \rc-Pc\r io OCdcptiohS as 

V-Uhtirwc CV\roVS. W 


⑧ You need to know that 
the method you’re 
calling is risky. 

|-f you 乙 a 灼 dome up a way bo do b 

less v-isky that avoids -tWoy/'mj the 

-thats -the best possible ou*tdomcf 
Bu*t some v-isks \us*t da^*t be avoided, a^d 

sJ . 

thats ^j\\cy\ you to do this. \ 

^ V 

④ You then write code 
that can handle the 
failure if it does 
happen. You need to be 
prepared, just in case. 



a class 
you wrote 


public void 

Process ( 工 nput i) { 
if (i. 工 sBad()) { 

Explode(); 




a class 


you wrote 



,THIS P^OG^fVA'S 126AUUY STABU6: 



your program 



aublic class Data •[ 
public void 
Process(Input i) { 
try { 

if (i.IsBadO ) 
explode(); 



user 


your class, now with 
exception handling 
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So when do I use try and catch? 

Any time you’re writing risky code, or 
code that could throw an exception. The trick 
is figuring out which code is risky, and which 
code is safer. 

You’ve already seen that code that uses 
input provided by a user can be risky. Users 
give you incorrect files, words instead of 
numbers, and names instead of dates, and 
they pretty much click everywhere you could 
possibly imagine. A good program will take 
all that input and work in a calm, predictable 
way. It might not give the users a result they 
can use, but it will let them know that it found 
the problem and hopefully suggest a solution 

How can a program suggest a 
solution to a problem it doesn’t even 
know about in advance? 

That’s what the catch block is for. A 
catch block is only executed when code 
in the try block throws an exception. It’s 
your chance to make sure the user knows 
that something went wrong, and to let the 
user know that it’s a situation that might be 
corrected. 

If the Excuse Manager simply crashes when 
there’s bad input, that’s not particularly 
useful. But if it tries to read the input and 
displays garbage in the form, that’s also not 



Dumb Questi9ns 

useful—in fact, some people might say 
that it’s worse. But if you have the program 
display an error message telling the user that 
it couldn’t read the file, then the user has an 
idea of what went wrong, and information 
that he can use to fix the problem. 

So the debugger should really only 
be used to troubleshoot exceptions then? 

A! No. As you’ve already seen many 
times throughout the book, the debugger’s 
a really useful tool that you can use 
to examine any code you’ve written. 
Sometimes it's useful to step through your 
code and check the values of certain fields 
and variables—like when you’ve got a really 
complex method, and you want to make sure 
it’s working properly. 

But as you may have guessed from the 
name “debugger,” its most common use is 
to track down and remove bugs. Sometimes 
those bugs are exceptions that get thrown. 
But a lot of the time, you’ll be using the 
debugger to try to find other kinds of 
problems, like code that gives a result that 
you don’t expect. 

I’m not sure I totally got what you 
did with the Watch window. 

A! When you're debugging a program, 
you usually want to pay attention to how 
a few variables and fields change. That’s 
where the Watch window comes in. If you 


add watches for a few variables, the Watch 
window updates their values every time you 
step into, out of, or over code. That lets you 
monitor exactly what happens to them after 
every statement, which can be really useful 
when you’re trying to track down a problem. 


The Watch window also lets you type in any 
statement you want, and even call methods, 
and the IDE will evaluate it and display the 
results. If the statement updates any of the 
fields and variables in your program, then it 
does that, too. That lets you change values 
while your program is running, which can 
be another really useful tool for reproducing 


exceptions and other bugs. 


you make m the IVa-Uh 

v/mdov/ just the daia ih 你⑽ vy, 

Ohly last as lohg Bs -the 
is \ruhhihg. Rcstairt youv- pv-ogv-am, 
values that you chafed will 


Tke catck block 
is only executed 
wken cocte in tke 
try block tkrows 
an exception. It 
gives you a ckance 
to make sure 
your user kas tke 
iniormation to lix 
tke problem. 
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go with the flow 


Use the debugger to follow the try/catch flow 


An important part of exception handling is that when a statement in 
your try block throws an exception, the rest of the code in the block 
gets short-circuited. The program’s execution immediately jumps to 
the first line in the catch block. But don y t take our word for it •… 



o 


❺ 


Add the try/catch from a few pages ago to your Excuse Manager app’s 
ReadExcuseAsync () method. Then place a breakpoint on the opening 
bracket { in the try block. 


— 


SerializationException is in the System. Runtime. 
Serialization namespace. Luckily, you already have 
using System.Runtime.Serialization 
at the top of your ExcuseManager.cs file. 


Start debugging your app and open up a file that’s not a valid excuse file (but still 
has the .xml extension). When the debugger breaks on your breakpoint, click the Step 
Over button (or F10) five times to get to the statement that calls ReadOb j ect () to 
deserialize the Excuse object. Here’s what your debugger screen should look like: 


三 public async Task ReadExcuseAsync Q 


Pui ihc b\rcakpo*mi oy\ 
the opchmj bv-a^kei o(. 
the i\ry blodk- 


Stef over the 
youv yellow 、以七 

shows the 灼 wt 

*to yt 
will v-cad 
七 he objedt 



o 



using (IRandofliAccessStream stream = 

await exc useFile. Ope nAsyn c( = il eAc cess.'-' ode. Re ad J) 
using (St re aim inputStream = st re am , AsSt re amFo r Re ad () J 

{ 

DataContractSerializer serializer 

= new DataContractSerializer (typeof (Excuse) ) ; 

Current Excuse = serializer, ReadOb jiect( inputStream) as Excuse^ 

} 

await new Message Dialog 「Excuse read from to ■’ 

+ excuseFile.lName) .5 howAsync()i 
On PropertyChanged ("CurrentExcuse") j 
await Update F iXeDateAsyn c()i 

} 

catch ( SerializationException) 

{ 

new Me s s a^e Di a log f 11 U n able to read " + excuseFile. Name) .ShowAsyncC) 
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Keep stepping through the code. As soon as the debugger executes the 

ReadOb j ect () statement, the exception is thrown and the program short-circuits 

right past the rest of the method and jumps straight to the catch block. 


The will 

hijhliglvt -the 

v/i'th 

i*ts yellow \以七 
如七加⑶七" blodk ； 
bu*t 1 七 shows -the 
v-csi o( -the blodk^. 

•m gv-ay {jo show you \ 
"thai its aboui io 
七 he whole 




◊ 


[- public a sync Task Re ad Exc u se Asy n c () 


try 

s 

using (IRandoiiriAccessStreaiT' stream = 

await exc use File. Ope n Asy n c ( F i 1 eAc ces s.'',od e. Read) ) 
using (Stream inputStream .= st re am , AsSt re am For Re ad ()) 

{ 

DataContraetSerializer serializer 

= new DataContractSerializer(typeof(Excuse J) ; 
CurrentExcuse = serializer , ReadObject(inputStreain) as Excuse; 

> 

await new I'-'lessageDialogC" Excuse read from to ■’ 

+ excuseFiie. Name).ShowAsync( 

On Prope rtyCha nged ( 1,1 Current Exc use ,F )^ 
await UpdateFileDateAsyn c()^ 

} 

(catch (SerializationException) 

{ 

new ' iiessageDialcgf "'Unable to read 11 + exc u seFile.Name ) . S howAsy n c () 

} 

> 



Start the program again by pressing the Continue button (or F5). It’ll begin 
running the program again, starting with whatever^ highlighted by the yellow 
“next statement” block 一 in this case, the catch block. It will just display the dialog, 
and then act as if nothing happened. The ugly crash has now been handled. 


Wtrts d Carter 

■bp: a 1 。七 C 养 

job 

m*tcv"vicv/s mtludc 
a about 

l^oy/ you dcdl 

m a 

乙 or\S*brud*toV. 




Keep risky code out of the constructor! 

Yoi/Ve noticed by now that a constructor doesn’t have a return 
value, not even void. That’s because a constructor doGsn’t 
actually return anything. Its only purpose is to initialize an object- 
which is a problem for exception handling inside the constructor. 
When an exception is thrown inside the constructor, then the statement that 
tried to instantiate the class won’t end up with an instance of the object. 


Watch it! 
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clean up after yourself 


If you have code that ALWAYS 
should ruw, use a finally block 


When your program throws an exception, a couple of things can happen. If the exception isn’t handled, your 
program will stop processing and crash. If the exception is handled, your code jumps to the catch block. But 
what about the rest of the code in your try block? What if you were closing a stream, or cleaning up important 
resources? That code needs to run, even if an exception occurs, or you’re going to make a mess of your 
program’s state. That’s where the finally block comes in really handy. It comes after the try and catch 
blocks. The finally block always runs, whether or not an exception was thrown. Here’s how you can use 
it to make sure the ReadExcuseAsync () method always fires the PropertyChanged event: 


public async Task ReadExcuseAsync() { 


try 

{ 

using ( 工 RandomAccessStream stream = 

await excuseFile.OpenAsync(FileAccessMode.Read)) 
using (Stream inputStream = stream.AsStreamForRead()) { 

DataContractSerializer serializer 


await new MessageDialog ("Excuse read from to ’▼ 

+ excuseFile.Name).ShowAsync(); 

await UpdateFileDateAsync(); 


=new DataContractSerializer(typeof(Excuse)); 
CurrentExcuse = serializer.ReadObject(inputStream) as Excuse; 

Callihg } 

^rcseis ihc Excuse 

object but the 

page woh’t \rcad 

the Cuv-v-ch-tEx^usc 

pv*opc\rty i-P ihe 

cvcht doesh^-t -five ca tch (SerializationException) 

The -finally blodk 

new MessageDialog("Unable to read 
NewExcuse (); 

} Add'm(x -to 

finally ^ ⑽ tru 如 


^akes su\rc -that the 

P\ropc\rtyChahgcd 
cvcht jets -Pivcd 
whether* ov- hot 

如 cxdcp-tioh was 

thv-oy/h. 


+ excuseFile.Name).ShowAsync(); 


*tWov/s d” 

OnPropertyChanged("CurrentExcuse"); 


Always catch specific exceptions like SerializationException. You typically follow a catch statement 
with a specific kind of exception telling it what to catch. It’s valid G# code to just have catch (Exception) and you 
can even leave the exception type out and just use catch. When you do that, it catches all exceptions, no matter 
what type of exception is thrown. But it’s a really bad practice to have a catch-all exception handler like that. 
Your code should always catch as specific an exception as possible. 
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❶ 

❻ 



Update the ReadExcuseAsync () method with the code on the facing page. 
Then place a breakpoint on the opening bracket in the try block and debug the 
program. 


Run the program normally, and make sure that the Open button works when you 
load a working excuse file. The debugger should break at the breakpoint you set: 


"the 'Wxt 

ba\r dhd the 
bv-cakpoiht av-c 

Oh the 

the IDE 

shows you the 
yellow d\r\roy/ 
pl^^cd ovc\r the 
kig <rcd dot ih 
"the 


:- public a sync Task ReadExcuseAsync () 


o 


using (IRandom^.ccessStreafn stream = 

await excuseF ile ■ Ope nAsyn c ( = i 1 eAc ces sl v o d e ■ Re ad) ) 
using (Stream inputStream = stream- AsStre amFor Read ()) 


DataContrsctSerializer serializer 

= new DataContractSerializer [ty peof ( Exc use)); 
CurrentExcuse = serializer.ReadObject ( inputStream ) as Excuse. 


} 


await new 'iessageDialog ( 9I Excuse read from to " 

+ excuseFile■ N ante ) ■ ShowAsync()^ 
await U pdate F ileDateAsyn c() ; 

} 

catch (SerializationException) 

{ 

new Me s s a ee Di a log f U n a b le to read " + excuseFile. Name 5 , ShowAsync f ) 
NewExcuse () j ^ 


finally 


Pay special -to y/hat happens 

wrth the didlo^s. Sorwctirwcs 3 didlo^ 

OnPropertyChanged ( 11 .Cu rre ntExcuse ,F ); displayed u»vtil sficr youv 

J method -pihishes. Wcldorwc to 七 he y/ovld 

of Ssy^hvo^ous mcihodsl 



Step through the rest of the method and make sure it runs the way you expect it to. It 
should finish the try block, skip over the catch block (because no exceptions were 
thrown), and then execute the finally block. 



Now try opening a malformed excuse file. The method should start executing the try 
block, and then jump to the catch block when it throws the exception. After it finishes 
all of the statements in the catch block, it’ll execute the finally block. 
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exceptions lead to instability 


Back up a second. So every time 
my program runs into an exception, it’s 
going to stop whatever it’s doing unless I 
specifically write code to catch it. How is 
that a good thing? 

One of the best things about 
exceptions is that they make it really obvious 
when you run into problems. Imagine how 
easy it could be in a complex application for 
you to lose track of all of the objects your 
program was working with. Exceptions call 
attention to your problems and help you 
root out their causes so that you always 
know that your program is doing what it’s 
supposed to do. 

Any time an exception occurs in your 
program, something you expected to happen 
didn’t. Maybe an object reference wasn’t 
pointing where you thought it was, or it was 
possible for a user to supply a value you 
hadn’t considered, or a file you thought you’d 
be working with suddenly isn’t available. If 
something like that happened and you didn’t 
know it, it’s likely that the output of your 
program would be wrong, and the behavior 
from that point on would be pretty different 
from what you expected when you wrote the 
program. 

Now imagine that you had no idea the error 
had occurred and your users started calling 
you up with incorrect data and telling you 
that your program was unstable. That’s why 
it’s a good thing that exceptions disrupt 
everything your program is doing. They force 
you to deal with the problem while it’s still 
easy to find and fix. 

OK, so then what’s the difference 
between a handled exception and an 
unhandled exception? 

A! Whenever your program throws an 
exception, the runtime environment will 



search through your code looking for a 
catch block that handles it. If you’ve 
written one, the catch block will execute 
and do whatever you specified for that 
particular exception. Since you wrote a 
catch block to deal with that error up 
front, that exception is considered handled. 

If the runtime can’t find a catch block to 
match the exception, it stops everything your 
program is doing and raises an error. That’s 
an unhandled exception. 

But isn’t it easier to use a catch-all 
exception? Isn’t it safer to write code that 
always catches every exception? 

A! You should always do your best 
to avoid catching Exception, and 

instead catch specific exceptions. You know 
that old saying about how an ounce of 
prevention is better than a pound of cure? 
That’s especially true in exception handling. 
Depending on catch-all exceptions is usually 
just a way to make up for bad programming. 
For example, you’re often better off using 
File. Exists () to check for a file 
before you try to open it than catching a 
FileNotFoundException. While 
some exceptions are unavoidable, you’ll find 
that a surprising number of them never have 
to be thrown in the first place. 

It’s sometimes really useful to leave 
exceptions unhandled. Real-life programs 
have complex logic, and it’s often difficult 
to recover correctly when something goes 
wrong, especially when a problem occurs 
very far down in the program. By only 
handling specific exceptions, avoiding 
catch-all exception handlers, and letting 
those exceptions bubble up to get caught on 
a top level, you end up with a more robust 
app because it will be immediately obvious if 
there’s a problem. 


What happens when you have a 
catch that doesn’t specify a particular 
exception? 

A catch block like that will catch any 
kind of exception the try block can throw. 

If a catch block with no specified 
exception will catch anything, why would 
I ever want to specify an exception type? 

\ Certain exceptions might require 
different actions to keep your program 
moving. Maybe an exception caused by 
dividing by zero might have a catch block 
where it goes back and sets properties to 
save some of the data you’ve been working 
with, while a null reference exception in the 
same block of code might require it to create 
new instances of an object. 

Does all error handling happen in a 
try/catch/finally sequence? 

A: No. You can mix it up a bit. You could 
have multiple catch blocks if you wanted 
to deal with lots of different kinds of errors. You 
could also have no catch block at all. It’s 
legal to have a try/finally block. That 
wouldn’t handle any exceptions, but it would 
make sure that the code in the finally 
block ran even if you got stopped halfway 
through the try block. But well talk a lot more 
about that in a minute.... 


An unkanctled exception 
means your program 
will run unprectictatly* 
Tliat’s wky tke program 
stops wkenever it runs 
into one. 


A sys-tcm s desired "to imrwedi^dy V*cpoV"*t 
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Paa] Puzz]c 

Your job is to take code snippets from 
the pool and place them into the 
blank lines in the program. You 
can use the same snippet more 
than once, and you won’t need 
to use all the snippets. Your 
goal is to make the program 
produce the output. 


class Kangaroo 

int croc; 
int dingo = 


Output: 


G r day Mate 


using System • 工 0; 

public static void Main() { 

Kangaroo joey = new Kangaroo(); 

int koala = j oey.Wombat( 

joey.Wombat(joey.Wombat(1))); 

try { 

Console.WriteLine( (15 / koala) 

+ " eggs per pound"); 

} 

catch (_) { 

Console . WriteLine (''G r Day Mate !") 


fs 


0 ; 


public int Wombat(int wallaby) 


try 


if 


croc — 0; 
else if (_ 
croc = 3; 
else { 


> 0 ) { 

.OpenWrite("wobbiegong"); 
< 0 ) { 


croc 


.OpenRead("wobbiegong"); 


catch ( 工 OException) 
croc — -3; 

} 

catch { 

croc = 4; 


finally 
if ( 


croc 


> 2 ) { 
dingo; 


Note: Each snippet 
from the pool can be 
used more than once! 



The pool puzzles are getting harder, and the names are getting more obscure to give you 
fewer hints. You’ll really need to work through the problem! Remember, the puzzles are 
optional, so don’t worry if you need to move on and come back to this one...but if you 
really want to get this stuff into your brain, these puzzles will do the trick! 
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one object’s trash is another^ treasure 



JhizzJey §©JlIf|©tl 


jocy.lVomboi-tO is called thv-cc 

times, and -the -third -time i*t 
\rctu\rhs zjcto . That douses 
the l/VvitcLihcO -(jo "thvow d 

DividcByZcv-oBxdcp-tioh. 


public static void Main() { 

Kangaroo joey = new Kangaroo(); 

int koala = j oey.Wombat(j oey.Wombat(j oey.Wombat(1))); 
try { 

Console.WriteLine( (15 / koala) + " eggs per pound") 

} 

catch ( DivideByZeroException ) { 

Console . WriteLine ( ''G r Day Mate ! ’， ）； 



The due 七 *this is d 
FilcS*t\rcamr\ is -that i"t hds 

by\ O^RcsdO method a 灼 d 

-thv-ov/s By\ lOE^dcftio^. 




Th i s " dc 外 ㈣ 仑 Ic tMcd V>bbicW 

a^d keeps \i opch the Usi ii^ c ^ 3 

Laic}r Ut agaih. 

饮 doscd ^ ^'Ic, 

It to thirow ah /OEx^cp-tioh. 


Vis ta'tdii blodk or\ly 

ta*Uiics c%tcP*t'ior\s >w\icvc 

class Kangaroo { toAt dWides by ^o. 

FileStream fs; 

int croc; 
int dingo = 0; 

public int Wombat(int wallaby) { 

dingo ++; 

try { 

if (wallaby >0) { 

fs = File. OpenWrite ( "wobbiegong"); 
croc = 0; 

} else if (wallaby < 0) { 

croc — 3; 

} else { 

fs = File. OpenRead ( "wobbiegong"); 


croc 


Remember you should avoid datdh— 
all c%dcf*t'ior>s *m youv todc- Bu 七 you 
should also avoid o*tV>cv y/c do 

-to make fuzzJes move like 

usm^ ob-fusda*tcd variable i^amcs. 


catch ( 工 OException) 
croc — -3; 


catch 


croc 


4; 



finally { 

if (dingo >2) { 

croc -= dingo; 


You dlreddy khov/ you always V>avc 
{jo dose -Piles 诎⑼ youVc Ao^c W\t\\ 

I-P you dont, tKc V/.II be 

locked Y ou ^ 

a^am rtll tWoy/ \0Uct^o^ 


return croc 


594 Chapter 12 


exception handling 


Use the Exception object to get 
mformatiow about the problem 

We’ve been saying all along that .NET generates an Exception object when 
an exception is thrown. When you write your catch block, you have access to 
that object. Here’s how it works: 


o 


❺ 


An object is humming along, doing its thing, when it encounters 
something unexpected and throws an exception. 



0 


O 


UH OWl WHAT 
THB HBCK 
HAPPBMBD? 


。〜 ct 


Luckily, its try/catch block caught the exception. Inside 
the catch block, it gave the exception a name: ex. 


try { 


DoSomethingRisky(); 


If a statement inside the 
DoSomethingRisky() 
method throws an exception 
that isn’t handled in the 
method, then it will be caught 
by the exception handler 
for the code that called it. If 
there’s no exception handler 
there, the exception will keep 
moving up the call stack. If it 
gets to the top of the call stack 
without being handled, then 
you end up with an unhandled 
exception that causes your 
_program to crash._ 



W\\cy\ you sfcdi-Py a -type o( 
i\\t blodk, i-P you fvovidc a variable 
youv* Code cby\ use i*t b> atdess 
七1 化 objedt 


catch (RiskyThingExceptionlex) 

string message = ex.Message; 

new MessageDialog( M I took too many risks! 


message).ShowAsync() 



The Exception object stays around until the catch block is done. 
Then the ex reference disappears, and it’s eventually garbage-collected. 
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playing catch 


Use more thaw one catch block to 
handle multiple types of exceptions 

You know that you can catch a specific type of exception.. .but what if you write code where more 
than one problem can occur? In these cases, you may want to write code that handles each different 
type of exception. That’s where using more than one catch block comes in. Here’s an example 
from the code in the beehive nectar processing plant. You can see how it catches several kinds of 
exceptions. In some cases it uses properties in the Exception object. It’s pretty common to use the 
Message property, which usually contains a description of the exception that was thrown. You can 
also call throw; to rethrow the exception, so it can be handled further up the call stack. 


You can also call 
the exception’s 
ToString () 
method to get 
a lot of the 
pertinent data 
into a dialog. 


public void ProcessNectar(NectarVat vat, Bee worker, HiveLog log) 
try { 

NectarUnit[] units = worker.EmptyVat(vat); 

for (int count = 0; count < worker•UnitsExpected, count++) 
stream hiveLogFile = log.OpenLogFile(); 

Sometimes you 
h> bubble 
By\ up 

•to method 

ihat called 

this or\t by 
us'm^ -th\rov /； *to 

\rrtWow the catch (HiveLogException ex 




throw 


} 





catch (IOException ex) { 


TVis blotk assies i\\t e% ⑼ W variable t%, 

•U 扣 use 铋 yt m-foymatior, 


Its -p'mc (or *t>wo 
blodks *to use 七 he 

/u )t\ 

SdmC 灼 C CX •/ 

-PoV* 'the 


worker.AlertQueen( n An unspecified file error happened : 


If 


Oh- 


▼▼Message: n + ex .Message + n \r\n TT 
TT Stack trace : n + ex. StackTrace + n \r\n TT 
▼▼Data: n + ex. Data + n \r\n TT ); 

^ oW^i ： 

Message, whidh has -the you’d ^ - i L ^ , 

window i, the IDB Hv7u y C ^ tioh 


finally { 

vat.Seal(); 

worker.FinishedJob() 

} 



c T4Z S S — 地祕 with it 
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Owe class throws an exception that 
a method m another class caw catch 。 : 广 。七 ^ r 侁 0 d 

\y\ tnc sar^e class. 

When you’re building a class, you don’t always know how it’s going to be used. Sometimes 
other people will end up using your objects in a way that causes problems — and sometimes 
you do it yourself! That’s where exceptions come in. 

The whole point behind throwing an exception is to see what might go wrong, so you can 
put in place some sort of contingency plan. You don’t usually see a method that throws 
an exception and then catches it. An exception is usually thrown in one method and then 


caught in a totally different one — usually in a different object. 

Instead of this... 

Without good exception handling, one exception can 
halt the entire program. Here’s how it would work in 
a program that manages bee profiles for a queen bee. 

—Mdile rprof.dat 


The BccP\ro^ilc object br\cd 

to 代 ad a kt it wash't 

so Filc.OpchRcadO 

th\rcw ay\ cxdcptioh. The hive 
didh so i 七 

Uhhdhdled. 




BccPvo^ilc objects dohst\ru^-tov- experts 
七 he lilcha^c a firolile data -Pile i\)ai i-tll 

卞 h us ， Filc.OpcO. I-P a 卜 bU 

opchihg the -Pile, the pv-ogva^ bombs out 

File.OpenRead(profile); 


An unhandled exception. 


tC.bileNothoundbcceptiorT 


FileNotFoundException 




l^oiit，c how -the BccPvofilc object 

—it u— 七 

^.teUgE^yO method, a,d i^ 0 

•t agam so its passed a\o^ h> the hiv C . 


■■we can do this. 

The BeeProf ile object can intercept the exception 
and add a log entry. Then it can turn around and 
throw the exception back to the hive, which catches it 
and recovers gracefully. 


try { 

stream = File.OpenRead(profile); 

} catch (FileNotFoundException ex) { 
WriteLogEntry("unable to find " + 
profile + " : " + ex.Message(); 
throw; 


try 



prof = new BeeProfile("prof.dat"); 


catch (FileNotFoundException) { 

Hive.RecreateBeeProfile("prof.dat"); 



Koy/ y/b ^ W»vc br\ts *to ^ 

_ okjett k 7 

m val.a •“孙 Wt 

{p I05 i\\t trror av\A *tV^c^ alert rt to 
七 pv-oblcw' by Bv\ c^c\>*t»oy\. 

TKc Wive tar\ *tV^c t%u^hov\ ay\d 
^akc some tor>ctcM\Mt *tK»s dasc, 

v-ctv-catm^ *tV^c kcc pvo^’le. 
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your very own exception 


Pees need an OutOfflowcy exception 

Your classes can throw their own exceptions. For example, if you get a null parameter in a method 
that was expecting a value, it’s pretty common to throw the same exception that a .NET method 
would: methods 七 -this i-P 七 hey jrt 

u ^ m ^ . mvalid o\r u^oepedied values m -theiv- pav-arwetev-s. 

throw new ArgumentException (); 1 1 

But sometimes you want your program to throw an exception because of a special condition that 
could happen when it runs. The bees we created in the hive, for example, consume honey at a 
different rate depending on their weight. If there’s no honey left to consume, it makes sense to have 
the hive throw an exception. You can create a custom exception to deal with that specific error 
condition just by creating your own class that inherits from Exception and then throwing the 
exception whenever you encounter a specific error, 
class OutOfHoneyException : System.Exception { 

public OutOfHoneyException(string message) : base(message) { } 

} - * n/ou bo Create a dlass -fov youv 

class HoneyDe livery System { ar>d make suv-c 

mKcV"i*ts -fvom Mozt^C 

\\o^i ovcvloadm^ 七 ^ £.oy\s*tvut*toV" 

public void FeedHoneyToEggs () { so ^ cav\ pass a 於 message- 

if (honeyLevel == 0) { 

throw new OutOfHoneyException("The hive is out of honey. 
} else { 

foreach (Egg egg in Eggs) { 


丁 Wis tWro 叫 s a 

S h ° h 7 ^ ^ objedt 

hive, 七 he will 

hcvcv- get thvowh dhd 

"this Code will vuh. 


Exception 


Message 

StackTrace 


GetBaseExceptionf) 

ToStringQ 



your Exception 


Message 

StackTrace 


GetBaseExceptionf) 

ToStringQ 




public partial class Forml : Form 


private void consumeHoney— Click(object sender, EventArgs e) { 
HoneyDeliverySystem delivery = new HoneyDeliverySystem(); 
try { 

delivery.FeedHoneyToEggs() 

} do whVt : ever you r\ttd h> do h> handle it 

catch (OutOfHoneyException ex){ 

MessageBox.Show(ex.Message , "Warning : Resetting Hive 
Hive. Reset () 

I 於 -this tast, \( KWc is ou*t o( Ko^cy y\oy\c 


You 匕扣 d 匕 us+ow\ 灼 by 

\us*t like a^y o*thcv* c 乂匕 eptioh by\A 

/haiev 


V 
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o( 七 he bees v/ovk, so s*imula*tov *t 

doy>tmuC. TV>C oy>ly >way bo keep i\\t firoyam 

v/ovkmg OY\tt hive v-u^s ou*t o( hoir>cy is 
*to V*CSC*t i*t> 3ir>d >wC CBy\ do 'that by 
-the dodc *to vesrt rt m 七 he daidh blotk. 


The hive is out of honey 


OK 





















exception handling 


public static void Main() { 

Console.Write("when it ") 
ExTestDrive.Zero("yes"); 
Console.Write(" it "); 
ExTestDrive.Zero ( "no"); 
Console. WriteLine — 



Exception Magnets 

Arrange the magnets so the application writes 
the output to the console. 


output: 

when it thaws it throws. 


class MyException : Exception 





Console.Write ( ,! a ,f ); 




Console .Write (” o ”）； 



Console. Write ( n t n ) ; j 


Console • Write ( ，， w n ) 


Console. Write (，’ s n ) 


try { 


catch (MyException) 


P= - [ 

throw new MyException(); | 

} finally { 

r - - 1 


DoRisky(test); 




class ExTestDrive 

public static void Zero(string test) 


static void DoRisky(String t) 
Console.Write("h"); 
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a little review 


public static void Main() { 

Console . Write ( "when it ’，） 
ExTestDrive.Zero("yes"); 
Console.Write(" it "); 
ExTestDrive.Zero("no"); 
Console. WriteLine — 


// 




Exception Magnets Solution 

Arrange the magnets so the application writes the 
output to the console. 


output: 

when it thaws it throws. 


class MyException : Exception 



t 


tailed 

\n\\\cM yb dau^irt \v\ a 
bio 乙 k m 七 he Codt- 


class ExTestDrive { 

public static void Zero(string test) 



Console • Write ( ，， t，，) 



Console • Wri te (” o ，， ) 



Console.Write ( ,f a ,f ) 



The Z-cv-oO rwc*thod cithcv- 

pv.m'ts “"thaws” o\r “*th\rows' 
oy\ whcihcv- it was 
passed u ycs w o\r sorwcth'mg else 
as iis -tes-t pavametev-. 


TVis Ime only c%c^u*tcd 
i-f poRiskyO docs^t 七 Wow 
七 he e % 匕 eftiow 





if (t 


’yes ’，） { 


t^ow^new MyException () ; | 



TKc -Pmally blodk makes suv-c 七 ha 七 
-the vrtihod always fv*m*b W >w' 
w s w is pv’m 七 ed ou*tsidc 
c%£.cp*tio^ ha^dlcv-, so i*t always 
*fcoo. 


static void DoRisky(String t) { 
Console.Write("h"); 



T. hc 祕勿 0 method ohl> 

th,rows ^ cx^p^ ioh ^ - 


passed *thc s*tv*i 
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exception handling 


BULLET POINTS - 

■ Any statement can throw an exception if something fails 
at runtime. 

■ Use a try/catch block to handle exceptions. 
Unhandled exceptions will cause your program to stop 
execution and pop up an error window. 

■ Any exception in the block of code after the try 
statement will cause the program's execution to 
immediately jump to the first statement in the block of 
code after catch. 

■ The Exception object gives you information 
about the exception that was caught. If you specify an 
Exception variable in your catch statement, that 
variable will contain information about any exception 
thrown in the try block: 

try { 

// statements that might 
// throw exceptions 
} catch (工 OException ex) { 

// if an exception is thrown, 

// ex has information about it 

} 

■ There are many different kinds of exceptions that 
you can catch. Each has its own object that inherits 
from Exception. Really try to avoid just catching 
Exception— catch specific exceptions instead. 


■ Each try can have more than one catch: 

try { … } 

catch (NullReferenceException ex) { 

// these statements will run if a 
// NullReferenceException is thrown 

} 

catch (OverflowException ex) { ... } 

catch (FileNotFoundException) { ... } 

catch (ArgumentException) { ... } 

■ Your code can throw an exception using throw ： 

throw new Exception("Exception message"); 

■ Your code can also rethrow an exception using 
throw ； but this only works inside of a catch block. 
Rethrowing an exception preserves the call stack. 

■ You can create a custom exception by inheriting from 
the Exception base class. 

class CustomException : Exception { } 

■ Most of the time, you only need to throw exceptions 
that are built into .NET, like ArgumentException. 
The reason you use different kinds of exceptions is so 
that you can give more information to your users. 
Popping up a window with the text “An unknown 

error has occurred” is not nearly as useful as an error 
message that says “The excuse folder is empty. Please 
select a different folder if you want to read excuses ■” 


Aw easy way to avoid a lot of problems: 
using gives you try awd finally for free 


y/he 的 you dedlaire 3 'm 

d U us'mj w i*ts PisposcO me 七 hod is 

au-tomatidally called a-t the o( -the block. 
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an ounce of prevention 


Exception avoidance: implement 
disposable to do your own cleanup 

Streams are great, because they already have code written to close 
themselves when the object is disposed. But what if you have your own 
custom object, and it always needs to do something when it’s disposed 
of? Wouldn’t it be great if you could write your own code that got run if 
your object was used in a using statement? 




(Disposable is a v-cally 

way *to avoid Con\tf\oy\ CXdcptiohS 

Ad piroblcn^s. /Wake suve you use 

usi ^9 youVc 

wo\rkihg with dass that 
irupIcrwChts it 


y o u CBv\ OK\ly use a dass m a usiM 
s*ba 七 emerrt i*f i*t IPisfosablcj 

。七 VievVise, youv 七 Compile. 


/ou 


wa 灼七七 0 


this.hive = hive 


G# lets you do just that with the I Disposable interface. Implement 
工 Disposable，and write your cleanup code in the Dispose () 

method，■ this: ^ ^ , Pisposablc ^ y< 

class Nectar : IDisposable { usc y° uv " object wi-thm a us'mj state 
private double amount; 
private BeeHive hive; 
private Stream hiveLog; 

public Nectar(double amount , BeeHive hive. Stream hiveLog) { 

this • amount = amount; Thc |p, sposa blc oy.ly has oy.c membev -： -the 

PisfoscO mc-thod. l/VKa*tcvcv you fu*t m this method will 

this.hiveLog = hiveLog; 

} 

public void Dispose() { 

if (amount >0) { 

hive .Add (amount); 

hive.WriteLog(hiveLog, amount + n mg nectar added to the hive 
amount = 0; 

} } (T 

> : … ai — One of the guidelines for implementing IDispose is that your 

^ ，h . C 如 (1 logs S message. Dispose () method can be called multiple times without side 

./ . 丄 ； mus 七 so wc pu 七 effects. Can you think of why that’s an important guideline? 

it m the PisposcO mcihod. "川 ， 

You " see nested usmg s-btcmch-ts like -this 

We can use multiple using statements now. First, let’s use a built-in object, when you y\ctd b> dcdlavc b^o (Disposable 

Stream, which implements IDisposable. Then, we’ll work with our v~e^evehdes m the sar^c blo^k o^* 6ode 

updated Nectar object, which also implements IDisposable: 


yt c%cdu*tcd a 七七 he end o( -the us*m^ statement..ov- 
dL- y/hc^cvcv- PisfoscO is dalled manually- 

TVis PisposcO 
was 

y/vi*t*tcr\ so i*t 

tould be tailed 

m3r\y tiw'CS, 

灼。七 jus 七 or\tt^ 


using 

using 




(Stream log = new File . OpenWrite ("log. txt f, )) 

(Nectar nectar = new Nectar(16.3, hive, log)) { 

Bee • Harvest (nectar) ， y/»ll c\ost auWatitally at 

Bee • FlyTo (hive) ; ) ^ ^ outer usm 3 

Thch the Bee objed: uses the 
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c ucc 卯严 uses the /Vc^-to 

y/ill add its hc^-fcav- -to 
hivc au-tomat.^lly at C hd o( 
七 he ihhClr usihg s-btcmcht 







exception handling 


tKeretare no 

Dumb Qi] 


Questions 


Is it possible to use an object 
with a using statement if it doesn’t 
implement IDisposable? 

A: No, you can only create objects that 
implement 工 Disposable with using 
statements, because they’re tailor-made for 
each other. Adding a using statement is 
just like creating a new instance of a class, 
except that it always calls its Dispose () 
method at the end of the block. That’s 
why the class must implement the 
工 Disposable interface. 

Can you put any statement inside a 
using block? 

A: Definitely. The whole idea with 
using is that it helps you make sure that 
every object you create with it is disposed. 
But what you do with those objects is 
entirely up to you. In fact, you can create an 
object with a using statement and never 
even use it inside the block. But that would 


Can you call Dispose () 
outside of a using statement? 

A! Yes. You don't ever actually need 
to use a using statement. You can call 
Dispose () yourself when you're done 
with the object. Or you can do whatever 
cleanup is necessary—like calling a stream’s 
Close () method manually. But if you use 
a using statement, it'll make your code 
easier to understand and prevent problems that 
happen if you don’t dispose of your objects. 

You mentioned a "try/ 
finally” block. Does that mean 
it’s OK to have a try and finally 
without a catch? 

A! Yes! You can definitely have a 
try block without a catch, and just a 
finally. It looks like this: 


try { 

DoSomethingRisky(); 
SomethingElseRisky(); 

} 

finally { 

AlwaysExecuteThis(); 

} 

If DoSomethingRisky () throws an 
exception, then the finally block will 
immediately run. 

Does Dispose () only work 
with files and streams? 

No, there are a lot of classes that 
implement 工 Disposable, and when 
you’re using one you should always use 
a using statement. (You’ll see some of 
them in the next few chapters.) And if you 
write a class that has to be disposed of 
in a certain way, then you can implement 
工 Disposable, too. 


be pretty useless, so we don’t recommend 
doing that. 



O 


IF TRY/6AT6H IS SO WHY 

D 沉 SM，T THB 工 JUST PUT IT AROUND 
BVBRVTHIM^? THBM WB W^UUDM^ 
HAVB JO WRITB AUU TNBSB mV/CATCH 
BUOCKS OUR OWN, Rld^HT? 


You want to know what type of exception is 
thrown, so you can handle that exception. 

There’s more to exception handling than just printing out a 
generic error message. For instance, in the excuse finder, if we 
know we’ve got a FileNotFoundException, we might 
print an error that suggested where the right files should be 
located. If we have an exception related to databases, we 
might send an email to the database administrator. All that 
depends on you catching specific exception types. 


"This is why -thc\rc so 
classes that ihlicHt 
Arom Exdcptioh, ahd why 
you r^y CVCh -to wv-i-tc 
you\f owh classes -to mhev-it 
from Exdcptioh. 
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the one that got away 

The worst catch block EVER: catch-all plus comments 

A catch block will let your program keep running if you want. 

An exception gets thrown, you catch the exception, and instead 
of shutting down and giving an error message, you keep going. 

But sometimes, that’s not such a good thing. 


Take a look at this Calculator class, which seems to be acting 
funny all the time. What’s going on? 

class Calculator { 


public void Divide(int dividend, int divisor) { 

Hcv-c s i\\t ^oblcw». 1+ d'wisov- 

try { ^ -- lS zjcv-o, *tWis Will (xtdkt a 

七咖 . 

this.quotient = dividend / divisor; 

_s a uit\\ blodk. So 

} catch { -- ' why a\rc wc still gettmg cv-v-ov-s? 

// Note from Jim: we need to figure out a way to prevent 


// people from entering in zero in a division problem. 


You should handle your exceptions, not bury them 


-thougli-t that he 
V doul<J his cxdcptiohs by us— 
如 empty datdh blodk, but he just 
匕 dused a -pov y/Kocvcv* 

had "to dovm P\robler»)S w'rth 

•t latcv-. 


Just because you can keep your program running doesn’t mean 
you’ve handled your exceptions. In the code above, the calculator 
won’t crash...at least, not in the Divide () method. But what if 
some other code calls that method, and tries to print the results? 

If the divisor was zero, then the method probably returned an 
incorrect (and unexpected) value. 

Instead of just adding a comment and burying the exception, 
you need to handle the exception. And if you’re not able to 
handle the problem, don } t leave empty or commented catch 
blocks! That just makes it harder for someone else to track down 
what’s going on. It’s better to let the program continue to throw 
exceptions, because then it’s easy to figure out what’s going wrong. 


Re 州 e 州 bev, 4 ⑼ youv- Code does / 七 

^dr\dle dr\ 

bubbles Cd\\ s'tddk* 

d 灼 bubble up is a pcv-fc^*tly 

valid y/ay dealm^ a” 

i 竹 d. 3 scs i^b 你 akes w'OVC s ⑼ sc 

•to do i\\ai "to use a 
blotk bo V^a^dlc 
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exception handling 


Temporary solutions are OK (temporarily) 

Sometimes you find a problem, and know it’s a problem, but aren’t 
sure what to do about it. In these cases, you might want to log the 
problem and note what’s going on. That’s not as good as handling 
the exception, but it’s better than doing nothing. 

Here’s a temporary solution to the calculator: 

class Calculator { 

• • • 

public void Divide(int dividend, int divisor) { 
try { 

this.quotient = dividend / divisor; 

} catch (Exception ex) { 



• “but ih \real li-fc, 

solu-tiohs have 

a hasty habit of 

pCV-mahCht 


Take a minute and think 
about this catch block. 
What happens if the 
StreamWriter can’t write to 
the C:\Logs\ folder? You can 
nest another try/catch 
block inside it to make it 
less risky. Can you think of 
a better way to do this? 


using (StreamWriter sw = new StreamWriter(@"C:\Logs\errors.txt"); 
sw.WriteLine(ex.getMessage()); 


O 


o 



I 6rBT IT. rr^ S^>RT O? UKB 
USIMd^ BXCBPTl^N HANDUIN^ 
TO PUA6B A MARKER IM TNB 

AREA. 




TWis still -bo be -f 
sV,ort-be^, -bW»s r,akes 

-bV^c 广 oWcm oddu^rvccl. , 

wuW 七 i 七 kc 

ou*t ^ Vo^ ^ WxAt ,s . 

tailed a dw 咖 m 

i\\t 的七 plate? 


Handling exceptions doesn’t always mean 
the same thing as FIXING exceptions. 

It’s never good to have your program bomb out. But it’s 
way worse to have no idea why it’s crashing or what it’s 
doing to users’ data. That’s why you need to be sure that 
you’re always dealing with the errors you can predict and 
logging the ones you can’t. But while logs can be useful 
for tracking down problems, preventing those problems in 
the first place is a better, more permanent solution. 


you are here ► 
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some quick suggestions 


A few simple ideas for exception handling 



p^sfqfN icm fo wan\>u 戸 afw 够 gKACEFOLLY- 



你 v 彡 ycm 的巩 s USEFUL ^kkok H^ssa<?K. 


o 



Th^ow 扒 ? Lf-?N Mtf ^vwfioNS wH^ yow ^in. Only fH^ow 

CUSfoH ^VC^pfiONS yow fo <J?V 彡 C^sfoH ?N^Haf|ON. 


o 



Th?n\; ago^f co\>^ In yew ky gLo^\c 相 a 千 COULP <?^f 
sho 好一你挪版 


o 



■and most of all... 



Avofp v^NN^ssa^y ^ sysf^n ^o^s...ALWAYS USE 

PLOCK AMY TIME YOU USE A STREAM! 









? i ^hy-thihj else 
*Bi3 七 n^pIcr^Ch'^s 
/Disposable. 
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exception handling 



Across 

5. The base class that DivideByZeroException and 
FormatException inherit from 

8. An_exception happens when you try to casta 

value to a variable that can’t hold it 

10. If the next statement is a method, “Step_ ” tells the 

debugger to execute all the statements in the method and break 
immediately afterward 

12. If you_your exceptions, it can make them hard to track 

down 

13. This method is always called at the end of a using block 

14. The field in the Exception object that contains a string 
with a description 

15. One try block can have multiple_blocks 

17. The_block contains any statements that absolutely 

must be run after an exception is handled 

18. An_exception means you tried to cram a 

number that was too big into a variable that couldn’t hold it 


Down 

1 ■ The window in the IDE that you can use to check your 
variables’ values 

2. You’ll get an exception if you try to divide by this 

3. Toggle this if you want the debugger to stop execution when it 
hits a specific line of code 

4. “Step_ ” tells the debugger to execute the rest of the 

statements in the current method and then break 

6. What a reference contains if it doesn’t point to anything 

7. You can only declare a variable with a using statement if it 
implements this interface 

9. When a statement has a problem, it_an exception 

11. A program that handles errors well 

16. If the next statement is a method, “Step_ ” tells the 

debugger to execute the first statement in that method 


you are here ► 
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get it? finally? yeah, we f re funny 



Exceptioncposs Solution 
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Priaw fmally gets 
his vacation... 

Now that Brian’s got a handle on his 
exceptions, his job’s going smoothly 
and he can take that well-deserved 
(and boss-approved!) vacation day. 


..and things arc looking 
up back home! 



Your exception handling skills did more 
than just prevent problems. They ensured 
that Brian’s boss has no idea anything 



Good exception 
kandlingf is invisible 

O 1 _ 一 

to your users. Tke 
program never craskes, 
and ii tkere are 


irotlems, tkey are 
landlect gfracefully ， 
witkout confusing error 


messages. 
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GAPm^KING 

OF t? 鱗 H ct 
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Home of 


yOU f RB TOO LATB! AS WBSPBAK 
My (LONE ARMyiS GArmiUCr IN 
TUB FACTORY BENEATH _ 


IVE GOT you NOW, 


Swindler. 


...READY TO WREAK HAVOC 
ON THE STREETS OF 
i OBTECrVlLLE! _ 


Objectvill 


e 


CAPTAIN AMAZING, ^BJBCTVIUUB^S tAOSl AMAZING 
OB^BCT, PURSUES HIS ___ 





III TAKE DOWN _ 
CLOUDS REFERENCES, ONE 
sy cm 
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IS THIS THB BNDO? 6APTAIN AMAZING 
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reenacting the crime 


c^^rpen your pencil 


Below is the code detailing the fight between Captain Amazing and Swindler (not to 
mention his clone army). Your job is to draw out what's going on in memory when 
the FinalBattle class is instantiated. 

assume 七 Clones was 
sc*t a 

public CloneFactory Factory = new CloneFactory(); 
public List<Clone> Clones = new List<Clone>() { . .. }; 

public SwindlersEscapePlane escapePlane; 


class FinalBattle 



. 此 tomy ob〆. 


public FinalBattle() { 

Villain swindler = new Villain(this); 
using (Superhero captainAmazing = new Superhero()) 

Factory.PeoplelnFactory•Add(captainAmazing); 

Factory.PeoplelnFactory•Add(swindler); 

captainAmazing.Think( n 工 '11 take down each clone's reference, 

one by one"); 

captainAmazing. 工 dentifyTheClones(Clones); 
captainAmazing.RemoveTheClones(Clones); 

swindler.Think("A few minutes from now, you AND my army will be garbage") 
swindler • Think ( n (collected, that is !)，'）； 
escapePlane = new SwindlersEscapePlane(swindler); o 


swindler.TrapCaptainAmazing(Factory) 
new MessageDialog("The Swindler escaped.")•ShowAsync(); 


❺ 




3 pidtuve o( v/ha*t "the will look like exactly 

one second a£tc\r -the PmalBatilc do^siv-ud-tov- v-u^s. 


Pv3y/ y/^3*t s ^onr\^ oy \ 
Kcv-c, 

Sy/mdlc^sta\>cPla^c 

object is 七 ed. 


[Serializable] 

class Superhero : 工 Disposable { 

private List<Clone> clonesToRemove = new List<Clone>() 
public void 工 dentifyTheClones(List<Clone> clones) { 

foreach (Clone clone in clones) 
clonesToRemove.Add(clone); 

} 

public void RemoveTheClones(List<Clone> clones) { 

foreach (Clone clone in clonesToRemove) 

Clones.Remove(clone); 




Thcv-c^s a Clo^c 

dlass -that v/cVc 灼 o 七 
shov/mg you m -this 
CoAt } too. You dor/*t 

y\ttA i*t *to a^sy/cv- 

^ucs-tio^s. 


T^s .ore 6ode P ； s ? oseO 

to ⑶七 |p-,s ? osaklc) v/e aw t 如職 3 丫⑽， 

but you d<^ 七 rt a^y/cr t^»s. 


class Villain { 

private FinalBattle finalBattle; 

public Villain(FinalBattle finalBattle) { 
this.finalBattle = finalBattle; 

} 

public void TrapCaptainAmazing(CloneFactory factory) { 

factory.SelfDestruct.Tick += new EventHandler(SelfDestruct_Tick); 
factory•SelfDestruct • 工 nterval = TimeSpan.FromSeconds(60); 
factory.SelfDestruct•Start(); 

} 

private void SelfDestruct_Tick(object sender, EventArgs e) { 
finalBattle.Factory = null; 
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the death of an object 


class SwindlersEscapePlane { 
public Villain PilotsSeat; 

public SwindlersEscapePlane(Villain escapee) 
PilotsSeat = escapee; 


class CloneFactory { 

public DispatcherTimer SelfDestruct = new DispatcherTimer(); 
public List<obj ect> PeoplelnFactory = new List<obj ect>(); 


/Wake suvc you add 
labels "to youv- objc^-ts 
■to show the 
variables that arc 

poih-tihg -to -them. 


o 



IVlc s-ta\rtcd -f iv-s-t oy\c -fov- you. Make suv-c you 
d\rdv/ m Imes shov/'m^ av-dhi*tc^*tuvc—wc dvcw B 

I'me -fvom dlo^e -fa^*fcov-y -fco object 

because -fad-fcov-y has v-c-fcv-c^^cs -fco i*t (via i*ts 
People-field). 


h"Qiw 0 ' 


Wve spa^c, as thcv-c is 

⑽代匕 be dirawh ai this stage. 


SWmdlevs c 鄉 ―. 


❺ 



❺ 


roum job ,s -to d^w wha^ 
%_ h 3 Oh ih -these ivjo bits 

o+ ^ennofry, -too. 


Based on your diagrams, where in the code did Captain Amazing die? 


Be sure to annotate that on your diagram, too. 


you are here ► 
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wonder what those numbers say 

c^^irpen your pencil 


❶ 

object 70 U 〆 
should (ave 

added W 、 


CA PTA 
A MA 2 I 




s 


❻ 

f\s lov\^ as 七 be’s a 
Yt(trCY\U bo sy/'mdlcv- 
-(*yow\ "tiiC CSd 3 ^cPl 3 i^C) 
lie ^OY\ ^ yi 
gav-bay-^ollc^cd- 


❺ 


ESCAPE 

PLANE 






Draw what’s happening in memory with the FinalBattle 
program. 



J hc ircW^c foists io a 

obje^i a,d the swi,dl^ 

广户卜 \/ilU obje^i a ,d dohC 

Pcop| c / h Fa^y list 
irc+circh^s io both of them. 



CAPTAIN 
AMA2ING 


The csdapcPbhc 

V-C-Pcv-ChdC how 
poihts -to d hew 
ihs-t^h^c o-p the 

Swmdlc\rsEsdapcPlahc 


V poihts -to -the 
l/illaih object- 



SW 1 ND 


57 


self 

estruc 


"the scl-PDcs'tvu^'t ■^iv'cs, "tlic *Pa^tov*y v*c-(*cv*c^dc 
vaviablc is set "to ywa\\, eligible -fov- ^dv*ba^e 
匕 ollection. So _仏 go^c \y\ this dv~dv/'m^. 

N 。 七 I 。％ a-f-tev- *the -fad*bovy v-c-fcv-c^dc v/ds 3 。灼 c, 
i*t "took *thc Clor\cFad*tov-y objcd*t v/i*th i*t—a^d 
ddused *thc Lis-t object v-c-fcv-ci^dcd by its 
People|^Fad*to\ry -field *to disappear...a^d 
v/ds *thc only *tWmj keeping *thc Supc\rttcv-o object 
'alive. Nov/ he’ll be dcs*broycd *thc 的 C 乂 *t 七 | 你 € -the 
^arbd^e CoWtthoir v-u^s. 



Based on your diagrams, where in the code did Captain Amazing die? 

void Scl-fDcst\rud*t Tidk(ob\cd*t schdcr, c) { ^Not \°^ ^ \ ^ 

… F riuli;. . 

I::::::::::::::::::::::::::.:::::::::::::::::::::::::::::::::::::::::: tV>c V>cvo vias ^c- 


v3^) 


Once finalBat tie Factory was set to null, it 
collection. And it took the last reference to the 

Chapter 13 


Ot\Ct the Supc\rhc\ro had y\c 












UATBR, AT THE FUNBEAU 
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Your last chawccto £0 something... 
your object's fmalizcr 

Sometimes you need to be sure something happens before your object 
gets garbage-collected, like releasing unmanaged resources. < 

A special method in your object called the finalizer allows you to write 
code that will always execute when your object is destroyed. Think of 
it as your object’s personal finally block: it gets executed last, no 
matter what. 

Here’s an example of a finalizer in the Clone class: 


In general, you’ll never write a finalizer for 
an object that only owns managed resources. 
Everything you’ve encountered so far in 
this book has been managed — meaning 
managed by the CLR (including any object 
that ends up on the heap). But occasionally 
programmers need to access an underlying 
Windows resource that isn’t part of the .NET 
Framework. If you find code on the Internet 
that uses the [Dlllmport] attribute, you 
might be using an unmanaged resource. And 
some of those non-.NET resources might 
leave your system unstable if they’re not 
“cleaned up” somehow (maybe by calling a 
method). And that’s whatfinalizers are for. 


class Clone { 

string Location; 
int ClonelD; 

public Clone (int clonelD, string 
this•ClonelD = clonelD; 
this.Location = location; 


Hcvc s i\\t l*t looks like 

七 k Clo^clP and \\t\ds art 

厂 ? o ? ulated t-e a Clo,e yts crM 

location){ 


public void TellLocation(string location, int clonelD){ 

Console.WriteLine("My Identification number is {0} and n + 

"you can find me here: {1}.", clonelD, location) 

} tk.s - w t»iac") says 

code m -tW,s blo^k yts ^ 

_ ^ okjett is yrloay - 乙。 llertcd. 


public void WreakHavoc(){... 


^^lone 


0 { 


TellLocation(this.Location, this.ClonelD); 

Console.WriteLine ("{0} has been destroyed", ClonelD); 



J his is 

I 七 SCh ^ s ^ message -to 

甘 ^3 ihc 

lodatio 
ID. But it will Ohly 
whch -the objc^ is 

gambage - 匕 olle 乙 ied. 


You write a finalizer method just like 
a constructor, but instead of an access 
modifier, you put a 〜 in front of the 
class name. That tells .NET that the 
code in the finalizer block should be 
run right before it garbage-collects the 
object. 

Also, finalizers can’t have parameters, 
because .NET doesn’t need to tell it 
anything other than “you’re done!” 



Watch it! 


Some of this code is for learning 
purposes only, not for your real programs. 

Throughout the book weVe made reference to 
how objects “eventually” get garbage-collected, 
but we never really specified exactly when that 
happens., .just that it happens sometime after the reference to 
the object disappears. WeYe about to show you some code that 
automatically triggers garbage collection using GC. Collect () 
and pops up a MessageBox in a finalizer These things mess 
with the “guts” of the CLR. We J re doing this to teach you about 
garbage collection. Never do this outside of toy programs. 
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the death of an object 


Whew EXACTLY does a fmalizer ruw? 


The finalizer for your object runs after all references 
are gone, but before that object gets garbage-collected. 
And garbage collection happens after all references 
to your object go away. But garbage collection doesn’t 
always happen right after the references are gone. 

Suppose you have an object with a reference to it. 

.NET sends the garbage collector to work, and it checks 
out your object. But since there are references to your 
object, the garbage collector ignores it and moves along. 
Your object keeps living on in memory. 

Then, something happens. That last object holding a 
reference toyour object decides to move on. Now, your 
object is sitting in memory, with no references. It can’t 
be accessed. It’s basically a dead object. 

But here’s the thing. Garbage collection is 
something that .NET controls ， not your objects. So 
if the garbage collector isn’t sent out again for, say, a 
few seconds, or maybe even a few minutes, your object 
still lives on in memory. It’s unusable, but it hasn’t been 
garbage-collected. And any finalizer your object 
has does not (yet) get run. 



TWis objedt 


Wcircs youv- objedt 
living ih mc^ov-y. 




/ou\r object is still 

oy\ the heap... 


• but how -fchcv-c 

avWt dhy 

-to i-t. 




^Objec> 


The Heap 


Finally, .NET sends the garbage collector out again. 
Your finalizer runs.. .possibly several minutes after the 
last reference to the object was removed or changed. 
Now that it’s been finalized, your object is dead, and 
the collector tosses it away. 

You can SUREST to .NET that it's 
time to collecfthe garbage 


⑽上芬 d 

tvasV^cs 'fouv 



/ 


P 


oofll 


°^er 


The Heap 


NET does let you suggest that garbage collection would 
be a good idea. Most times, you’ll never use this 
method, because garbage collection is tuned to 
respond to a lot of conditions in the CLR and 
calling it isn } t really a good idea. But just to see how 
a finalizer works, you could call for garbage collection 
on your own. If that’s what you want to do, just call GC . 
Collect (). 

Be careful, though. That method doesn’t force .NET 
to garbage-collect things immediately. It just says, “Do 
garbage collection as soon as possible.” 


public void RemoveTheClones( 

List<Clone> clones) { 

foreach (Clone clone in clonesToRemove) 
Clones.Remove(clone); 

GC.Collect(); 

Wc da 灼’七 emphasize jus*t how bad by\ idea 

it is "to use 6 {C Co\\tt\P \y\ a fv-oyam -thaVs ^o-t 
just a -toy, because it 匕扣 v-cally do^-Pusc the CLR 、 
to\\ctb»r. IVs *tool -fov 

about dolled ^。 灼 and so well build 

a *toy {fi flay v/rth i*t. you are here ► 619 









collect the garbage 


PisposeO works with using; 
fmalizers work with garbage collection 



Like you saw cav-licv, PisposcO wovks 
y/i-thou-t a us'mg s-ta-terwe^t iVhch 
you build d DisposcO r^rthod, rt 
should / 七 have any side c-P-Pcdts -that 
^3usc p\roblcrws i-r rt’s \ru^ tn\BY\y -times. 


When an object implements IDisposable ， its Dispose () is called at the end of the block after a 
using statement. If you don’t use a using statement, then just setting the reference to null won’t 
cause Dispose () to be called — you’ll need to call it directly. An object’s flnalizer runs at garbage 
collection for that particular object. Let’s explore how these two patterns differ. Start up Visual 
Studio for Windows Desktop and create a Windows Forms Application project. 

❶ Create a clone class that implements iDisposabie and has a finalizer. 

The class should have one int automatic property called Id. It has a constructor, a 
Dispose () method, and a finalizer: 





侧餐 


using System.Windows.Forms; 

class Clone : IDisposabie { 

public int Id { get; private set; 

r S'mtc tlass _lc 啪 c\rrb 



public Clone (int Id) 
this.Id = Id; 

} 


|p-,sposaklc, *»*t V^as -to Kavc a 
P'lSfOScO W\C*t^od- 


Poff'mg uf a 
McssajcBo% m a 

•rmaliz^v t^Y\ mess 
y/ith *thc U ^u*ts w o-f 

■the CLR. Dor / 七 

do i*t outidc o-f a 
•toy pvoyam -fov* 
abou*t 

^av-ba^e dollc^*tio^. 

O 


public void Dispose() { 

MessageBox.Show("I A ve been disposed! 

"Clone #’▼ + Id + ’▼ says.. 

} / ~^ ^ H wi || ^ Uh wkh ihc 

Clone () { ob J^ 9^ 9a,ba 9 e^olle^d. 

MessageBox.Show("Aaargh! You got me! 

"Clone #" + Id + ’▼ says.. 


Here’s a good example 
of how desktop apps 
can make good tools for 
exploring C# and .NET. 
In this project, you’ll 
go back to creating a 
Windows Forms project 
to take advantage of 
the way MessageBox 
windows block as a tool 
to explore how garbage 
collection works. 


没 uidk \remihde\r ： i-p youVc us'ma 
l/_sual Studio Pv-o^Fcssiohal, 
Pv-Cmium, o\r Wltima 七 e, you Gh 
both W\v\do^is S-fcov-c 
如 d IVihdows Desk-top apps. 


s ^ vfou 
sWW ⑽ ate. - 


TilC method 

⑽ ates a 
Clor\C _ 
and 从⑼ 
immcdi 3 *tcly 
kills it by 

•rts 


Create a Form with three buttons. 

Create one instance of Clone inside the Click handler for the first button 
with a using statement. Here’s the first part of the code for the button: 

private void clonel_Click(object sender, EventArgs e) 
using (Clone clonel = new Clone(1)) { 




Clones 





// Do nothing! 

Smtc dtdartd dlor\cl 
v/i 七 a us'm^ s*ta 七 eme 此 i*b 
PisposcO mc-tiiodi yb v-ur\. 



iVr bUk is 

sups. 
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❺ 


You da 灼 make IDs -Pov- i^a^y — ^ 

objects—itll add Z^, Z4=, cic. 


Add the other two buttons. 

Create another instance of Clone in the second button’s Click handler, 
and set it to null manually: 

private void clone2_Click(object sender, EventArgs e) 
Clone clone2 = new Clone(2); 
clone2 = null; S'mdc this doesir / 七 use a 

} ^ -- s'ta'teme 此 Dispose 。 y/oh ；> t cvev jrt 

vuh, but "the -Pmaliz^v- y/ill. 

For the third button, add a call to GC • Collect () to suggest 
that garbage collection occur. 

private void gc_Click(object sender, EventArgs e) { 

GC.Collect(); 

} 一 This suggests -that 

jairbajc dollcdtioh iruh. 


Add a watch for one of 
the Clone references, 
right-click on it, and 
ChOOSe Make Object IDI to 


add the name 1# to your 
Watch window. This 
lets you keep watching 
the object even after 
the reference goes out 
of scope. The Watch 
window will let you 
know when the object is 
collected (you may need 
to Click Q to refresh it). 




o 


Run the program and play with Dispose () and finalizers. 

Click on the first button and check out the message box: Dispose () runs first. 


really rt’s jr\o*t 
3 ycat ided 'bo do -this. But 
it’s (\y\c licvc, because it’s 

a jood v/ay b> Icav-^ abou-t 

£ollectio 灼 . 


Clone #1 says,.. 


D 


po^*t -fovyt *to add W” 

System Wrndoy/s.FoVms ； *to 

*bof Y ouV " Clor^c dass. 



^ VCh 仏 the dohe/ 

° W ^ bcCh sci ^11 

3yxd 〜 pw method has 
^ Uh ； ，is r s ^l oh ihc heap 
wa，t,h 9 ^ 9^ba 3 c 


Garbage is collected. . .eventually. In most cases, you won } t 
see the garbage collection message box, because your object 
is set to null, but garbage collection hasn’t run yet. 

Now click on the second button...nothing happens, right? 
That’s because we didn’t use a using statement, so there’s 
no Dispose () method. And until the garbage collector 
runs, you won’t see the message boxes from the finalizer. 

Now click the third button, to suggest garbage collection. 

You should see the finalizer from both clonel and cl one 2 
fire up and display message boxes. 




ie ob 、 

The Heap 

NoY/ t\0Y\t2- 

\s oy^ 

•to vb. 



e ob 、 


Clone #2 says.., ^9 


Clone #1 says... ^9 

Aaargh! You got me! 

Aaargh! You got me! 

I OK 

OK 






oof! 


poof!— 



A* 




The Heap 


W\\tY\ $C.Colkd：() is \ruh bath objects 
c^ui^kly vu^ theiv* -f'malizjcv-s av\d disapfeav. 

Play around with the program. Click the Clone #1 button, then the Clone #2 button, then the GC 

button. Do it a few times. Sometimes Clone #1 is collected first, and sometimes Clone #2 is. And once in 

a while, the garbage collector runs even though you didn’t ask it to using GC . Collect (). 

you are here ► 
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an unstable environment 


Fmalizers ca^t depend oh stability 


Let’s say you’ve got 
two objects that have 


When you write a finalizer, you can’t depend 
on it running at any one time. Even if you call 
GC .Collect () — which you should avoid, unless 
you have a really good reason to do it — you’re only 
suggesting that the garbage collector is run. It’s not a 
guarantee that it’ll happen right away. And when it does, 
you have no way of knowing what order the objects will 
be collected in. 

So what does that mean, in practical terms? Well, think 
about what happens if you’ve got two objects that have 


references to each other... 



references to each other. If object #1 is collected first, 


then object #2’s reference to it is pointing to an object 
that’s no longer there. But if object #2 is collected 
first, then object #l’s reference is invalid. So what that 
means is \hdXyou can } t depend on references in 
your object’s finalizer. Which means that it’s a really 
bad idea to try to do something inside a finalizer that 
depends on references being valid. 


...if they’re both marked for garbage 
collection at the same time, then 
object #1 could disappear first... 


Serialization is a really good example of something that 
you shouldn’t do inside a finalizer. If your object’s 
got a bunch of references to other objects, serialization 
depends on all of those objects still being in memory... 
and all of the objects they reference, and the ones those 
objects reference, and so on. So if you try to serialize 
when garbage collection is happening, you could end 



up missing vital parts of your program because some 
objects might’ve been collected before the finalizer ran. 

Luckily, G# gives us a really good solution to this: 

工 Disposable. Anything that could modify your core 
data or that depends on other objects being in memory 
needs to happen as part of a Dispose () method, not 
a finalizer. 

Some people like to think of a finalizers as a kind of 
fail-safe for the Dispose () method. And that makes 
sense — you saw with your Clone object that just 
because you implement IDisposable, that doesn’t 
mean the object’s Dispose () method will get called. 
But you need to be careful — if your Dispose () 
method depends on other objects that are on the heap, 
then calling Dispose () from your finalizer can cause 
trouble. The best way around this is to make sure you 
always use a using statement any time you’re 
creating an IDisposable object. 


...on the other hand, object #2 could 
disappear before object #1. You’ve 
got no way of knowing the order... 



...and that’s why one object’s 
finalizer can’t rely on any other 
object still being on the heap. 
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the death of an object 


Make m object serialize itself m its PisposeO 

Once you understand the difference between Dispose () and a 
finalizer, it’s pretty easy to write objects that serialize themselves out 
automatically when they’re disposed of. 


o 



❿ 


^oY\t ba^k 
*to usmj bmav-y 

scv"ializ^*bo 灼 

by\A hav-d^oded 

di\rCd*to\rics as 
tcadlimg -tools 

because -thcyVc 
simple 一 

because v/c doir/*t 
you domg 
■this "m live Code! 
This is OY\ ly -for 
■toy pv-oyams. 


this! 

MAKE THE Cu>NB CLASS (FEOM PA^B (bZO) SBRIAU2ABUB. 

Just add the Serialize able attribute on top of the class so that we can save the file out. 

[Serializable] 

class Clone : IDisposable 

MODIFY 6U^MB X S l>TSPOSe() METHOD JO SBRIAUI2B ITSBUF OUT TO A FIUB. 

Let’s use a BinaryFormatter to write Clone out to a file in Dispose () : 

_ __ You ll y^ttA 3 

using System. 10; - - 〜 ^ woyrC ^ 

using System. Runtime .Serialization . Formatters . Binary; (JiVcd-twcs *to 

aacss 1 /0 


// existing code 

public void Dispose () { 

string filename = @ n C:\Temp\Clone.dat 
string dirname = @ n C:\Temp\ n ; 
if (File.Exists(filename) == false) { 
Directory.CreateDirectory(dirname); 



Masses v/cll 

The C| 0hc wi || ⑽七 “ he 

lcrn ? ⑽ 
ihel^ out io a 

hlc CUc.dat 


BinaryFormatter bf = 
using (Stream output = 
bf.Serialize(output, 

} 

MessageBox.Show("Must. 

"Clone 


new BinaryFormatter(); 

=File.OpenWrite(filename)) 
this); 



.serialize...object!" 
#" + Id + " says •••’▼) 


❹ 


EUM THE APPUICATI^M. 

You’ll see the same behavior you saw on the last few pages.. .but before the 
clonel object is garbage-collected, it’s serialized to a file. Look inside the file 
and you’ll see the binary representation of the object. 




Wc \\Brdtodtd the -filename— 
wc mdluded them as 
litcv-als m *thc dodc. ThaVs 
-fmc (ov b small *toy pv-oyam 

like this, but it’s 的 。七 Piroblcm- 
-fvee- Cby\ you *thmk o-r 
pv-oblcms this 
how you dould dv/oidi 




There’s a lot to think about in this project! What do you think the rest of 
the SuperHero object’s code looked like? We showed you part of it on 
page 623. Could you write the rest now? More importantly, should you? 

It’s clearly possible to have your object serialize itself when it’s disposed. 
But is that a good idea? Does it violate separation of concerns? Could it 
lead to code that’s hard to maintain? What other problems could occur? 


/W is this PisposcO 
method \rcally 
-f\rcc? I/Vhat happens i-p its 
called more 

These a\re all *thi 呼 you 
Y\tcd h> thrnk abou*t when 
you iPisposablc* 


you are here ► 
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what happened to the captain? 
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Fireside Chats 


Tonighfs talk ： the Dispose() method and a finalizer spar 
over who’s more valuable. 


Dispose(): 

To be honest, I’m a little surprised I was invited here. 

I thought the programming world had come to a 
consensus. I mean, I’m way more valuable than you 
are. Really, you’re pretty feeble. You can’t even serialize 
yourself out, alter core data, anything. Pretty unstable, 
aren’t you? 


There’s an interface specifically because I’m so 
important. In fact, I’m the only method in it! 


OK, you’re right, programmers need to know they’re 
going to need me and either call me directly or use a 
using statement to call me. But they always know when 
I’m gonna run, and they can use me to do whatever they 
need to do to clean up after their object. I’m powerful, 
reliable, and easy to use. I’m a triple threat. And you? 
Nobody knows exactly when you’ll run or what the state 
of the application will be when you finally do decide to 
show up. 


So there’s basically nothing you can do that I can’t do. 
You think you’re a big shot because you always run with 
GG, but at least I can depend on other objects. 

Chapter 13 


Finalizer: 


Excuse me? That’s rich. I’m feeble...OK. Well, I didn’t 
want to get into this, but since we’re already stooping 
this low...at least I don’t need an interface to get started. 
Without IDisposable, you’re just another useless 
method. 


Right, right.. .keep telling yourself that. And what 
happens when someone forgets to use a using 
statement when they instantiate their object? Then 
you’re nowhere to be found. 


Hahdlcs a\rc what you\r pv-ogva^s use wkh 

9° MT ahd ihe CLR a^d 

dijrcdtly with iVihdows. 

NET docs^i khow abou-t \i 
therw up -fov- you. v 

OK, but if you need to do something at the very last 
moment when an object is garbage-collected, there’s no j 

way to do it without me. I can free up network resources^/^ 
and Windows Jiandles and streams and anything else 
that might cause a problem for the rest of the program 
if you don’t clean it up. I can make sure that your 
objects deal with being trashed more gracefully, and 
that’s nothing to sneeze at. 


That’s right, pal — I always run; you need someone else 
to run you. I don’t need anyone or anything! 



theve^a 

Dumb 


are no o 

Questi9ns 


Can a finalizer use all of an object’s fields and methods? 

A! Sure. While you can’t pass parameters to a finalizer method, 
you can use any of the fields in an object, either directly or using 
this— but be careful, because if those fields reference other 
objects, then the other objects may have already been garbage- 
collected. But you can definitely call other methods and properties in 
the object being finalized (as long as those methods and properties 
don’t depend on other objects). 

What happens to exceptions that get thrown in a finalizer? 

Good question. It’s totally legal to put a try/catch block 
inside a finalizer method. Give it a try yourself. Create a divide-by- 
zero exception inside a try block in the Clone program we just 
wrote. Catch it and throw up a message box that says “I just caught 
an exception." right before the “".I’ve been destroyed.” box we’d 
already written. Now run the program and click on the first button 
and then the GC button. You’ll see both the exception box and the 
destroyed box pop up. (Of course, it’s generally a really bad idea 
to pop up message boxes in finalizers for objects that are more than 
just toys...and those message boxes may never actually pop up.) 


How often does the garbage collector run automatically? 

A! There’s no good answer to that one. It doesn’t run on an easily 
predictable cycle, and you don’t have any firm control over it. You can 
be sure it will be run when your program exits. But if you want to be 
sure it’ll run, you have to use GC • Collect () to set it off...and 
even then, you’re only suggesting that the CLR should collect now. 

How soon after I call GC • Collect () will .NET start 
garbage collection? 

A: When you run GC . Collect (), you’re telling .NET to 
garbage-collect as soon as possible. That’s usually as soon as .NET 
finishes whatever it’s doing. That means it'll happen pretty soon, but 
you can’t actually control when. 

So if something absolutely must run, I put it in a finalizer? 

A! It’s possible that your finalizer won’t run. It’s possible to suppress 
finalizers when garbage collection happens. Or the process could end 
entirely. If you aren't freeing unmanaged resources, you’re almost 
always better off using 工 Disposable and using statements. 
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But SOMBTHlNe f S wROUCr. UB 

DOESN'T SBBM THE SAME … AND 
HIS POWERS ARB WBIRD. ^ 


MBAMWHIUB, Obi THE STEBBTS Of ^BJBCTVIUUB— 



m 


m 


6VBN UATBR 


VOHAT'S WR^Nd? VOHY 
ARB THE OAPTAIN^S 
P^WBES BEHAVING 
DIFFBRBMTUY? IS 
THIS THE BMD? 
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the death of an object 


A struct looks like an object... 

One of the types in .NET we haven’t talked about much is the struct. 

Struct is short for structure, and structs look a lot like objects. They 
have fields and properties, just like objects. And you can even pass them 
into a method that takes an object type parameter: 

public struct AlmostSuperhero : IDisposable { 
public int SuperStrength; 

public int SuperSpeed { get; private set; 1 

public void RemoveVillain(Villain villain) 

{ 

Console . WriteLine ( n 0K A ’▼ + villain .Name + 

’▼ surrender and stop all the madness! 
if (villain.Surrendered) 
villain.GoToJail(); 

else 

villain.Kill(); 


but t 

subclass Masses. 

〜 d avc scaled, so 

kc subclassed. 



public void Dispose() { 


.but isw't aw object 


But structs aren } t objects. They can have methods and fields, but they 
can’t have finalizers. They also can’t inherit from other classes or structs, 
or have classes or structs inherit from them. 



A" ihhev-i-t -fv-om 

Sys-tcmValucTypc, whidh ih 

t 心 ihhcH-ts +v-om System. 

why cvcv*y 
乙七 has a 7oS"tv*iir>0O 
i-t gets it -fv-om 
But i^i } s all the 
McirrUg i^ai si^is are 

dllowccl io do. 

^ / \ 

f struct } 



^ “匕占七 hdaUc 
objed: with a sWi but 
s-t^ru^is dor!i siahd ih v 饮 y 

well Complex ihhcv-i-bhdc 



A s-t\ru^-t C^y\ have 

p\ropc\rtics ahd -fields... 
.dy\d •… e mc*t^ods. 


Tke power oi objects 
lies in tkeir ability 
to mimic real-world 
tekavior, tkrougfli 
inkeritance and 
polymorpliisni. 

Structs are test 
used lor storing 
data，tut tke lack 
ol inkeritance and 
reierences can l>e a 
serious limitation. 


Tha^s why you use classes a \d ^ 

docWt ^ M 


But the thing that sets structs apart from objects more than almost anything else is that 
you copy them by value, not by reference. Flip the page to see what this means....' 


you are here ► 
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makin’ copies 


Values get copied; references get assigned 


忏 的 s a <\u'uik vc-fvcshcv 

value types vs. objects. 


Oh 


You already have a sense of how some types are different than others. On one hand 
you’ve got value types like int ， bool, and decimal. On the other hand, you’ve 
got objects like List, Stream, and Exception. And they don’t quite work 
exactly the same way，do they? 

When you use the equals sign to set one value type variable to another, it makes a 
copy of the value, and afterward the two variables aren’t connected to each other. 

On the other hand, when you use the equals sign with references, what you’re doing is 

pointing both references at the same object. 

Variable declaration and assignment works the same with 
^ value types or object types: m 七孙 d bool List 

int howMany = 25 ; ar^d avc object -types. 

£ r'lasses? m, i-t boGl Scary = true; ^ 

^ •thaVs 七 List<double> temperatures = new List<double> (); 

1007 add va*tc—"tV^cy Exception ex = new Exception ("Does not compute"); 

also live m s*bru6*ts. 

Differences creep in when you start to assign values, though. Value types all are 

handled with copying. Here’s an example: _This lihe fogies value "that’s stoV" d 

- ，h -fi-f-tcCh/Woirc variable ih-to -the 

int fifteenMore = howMany; now/l/Jahy variable dhd adds 1^ h> 

variable has 

l^p OY\ 

howMany, 3r>d 

vide vcvsa. The output here shows that f if teenMore and howMany are not connected: 

_howMany has 25, fifteenMore has 40 



These d\re dll 

m the 

same bdsi 匕 way- 


int fifteenMore = howMany; 
fifteenMore += 15; 

Console.WriteLine("howMany has {0}, fifteenMore has {1} 

howMany, fifteenMore); 


With object assignments, though, you’re assigning references, not actual values: 


temperatures.Add(5 6.5 D); 

TV’s l.me sc*ts -the temperatures . Add ( 27 . 4D ) ; 
di-ffcv-c^-tLis-t f^List<double> different List 
-to pom-t different List .Add ( 62.9D); 

io the same objedi 
as -the ■tcrwpcv-a'tuv-cs 
v-c-Pcv-ci^dc- 

So changing the List means both references see the 
update...since they both point to a single List object. 


EMPERATURE 


temperatures; 





Bo-tV^ vc*fcv-cv\6cs 

▽om*t a 七七 k same 
a6*buidl object 


F F E R E N T 




Console.WriteLine("temperatures has {0}, differentlist has {1} 

temperatures.Count (), differentList.Count()) 
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The output here demonstrates that different List and 
temperatures are actually pointing to the same object: 

temperatures has 3, differentList has 3 


You ddlled d'»Wcv-c^*tL.'istAddO, 
\C added a _ tcm^atuv-c to 

okjett a^W^List av^d 

*tcw'\ > cv-a*tuv-cs pom 七 "to. 




the death of an object 


Structs are value types; objects are rcfcrcwcc types 


When you create a struct, you’re creating a value type. What that means 
is when you use equals to set one struct variable equal to another, you’re 
creating a fresh copy of the struct in the new variable. So even though a 
struct looks like an object, it doesn’t act like one. 

^ Create a struct called Dog. 

Here’s a simple struct to keep track of a dog. It looks just like an object, but it’s not. Add it 

to a new console application. 



IS 



public struct Dog { 、 , , 

public string Name; "tWis 

public string Breed; C Bear 必一 

public Dog(string name, string breed) { 
this.Name = name; 
this.Breed = breed; 

} 

public void Speak() { 

Console.WriteLine( M My name is {0} and 工 ， m a {1} . ", Name, Breed); 


Create a class called Canine. 

Make an exact copy of the Dog struct, except replace struct with class and then 
replace Dog with Canine. (Don’t forget to rename Dog’s constructor.) Now you’ll have a 
Canine class that you can play with, which is almost exactly equivalent to the Dog struct. 


^ood eMapsula 七 io 灼 . 

y,cVc a 七 . 



Add a Main ( ) method that makes some copies of Dogs and Canines. 

Here’s the code for the Main () method: 



Canine spot = new Canine ("Spot" M pug M ); 

Canine bob = spot; 

bob.Name = "Spike"; 

bob.Breed = "beagle"; 

spot.Speak(); 

Dog j ake = new Dog("Jake ", "poodle"); 

Dog betty = j ake; 
betty.Name = "Betty"; 
betty.Breed = "pit bull"; 
jake.Speak(); 

Console.ReadKey(); 

Before you run the program... 


You’ve already used 
structs in your programs 
Remember DateTime 
from previous chapters? 
You were working with a 
struct the whole time! 


c^^rpen your pencil 


Write down what you think will be written to the console when you run this code: 
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stack versus heap 


c^^rpen your pencil 


What did you think would get written to the console? 

My name is Spike and I'm a beagk- 
My name is Jake awd Kw a poodle, 


Here's what happened... ca^mc ^ 

The bob and spot references both point to the same object, so *tV^c 

pom*ts to * 乞 . 

both changed the same fields and accessed the same Speak () 
method. But structs don’t work that way. When you created 
be tty, you made a fresh copy of the data in j ake. The two 
structs are completely independent of each other. 



Canine spot 
Canine bob = 
bob.Name = "Spike"; 
bob.Breed = "beagle 


new Canine ("Spot 
spot; (z) 


’ ’pug n ); ① 

The 

vamidble bob v/as 

Crested, bu-t t\o v\t^i object v/ds added 
"to "the 一 "the bob vdv^idblc pom-ts -to 

七 he same object as spot. 


spot.Speak(); 


SiMe spo-t ar>d bob both po’m 七 "to the same objed-t, 
spot%akO and bob-SpcakO both dal I Ihc same 
method, av\d both o( -them pmodude -the same ouipui 
v/i 栎 w S P ikc w ay^d %ca 9 lc w 


① 


7^ Spot 、 





Dog j ake = new Dog("Jake ", 
Dog betty = j ake;^ 5 ^ 
betty.Name = "Betty"; 


betty.Breed 


'pit bull 


j ake.Speak() ;^ 6 ) 


Wken you set one struct 
eejuat to anotker, you’re 
creating a fresk COPY of 

tke data inside tke struct. 
Tlrat’s because struct is a 

VALUE TYPE 

13 


’poodle") 

W\\cy\ you d\rca*tc a new stv-ud*t, 
i 七 looks v-cally similav- *to dvcatmj 
by\ objedt—you vc yt a variable 
*tha*t you taY\ use *to addess i*b 
-fields By\A methods. 


ttcv-c^s -the big di-P-Pcv-c^c- W\\ty\ ^5^ / ^ ‘、 

you added -the bet-ty variable ； Jake 

you dv-catcd a whole ^ev/ value- 1 poodle 


④ / 


Jake 
poodle 

、<- 、一. 

jake 


/ 


、 _ 一 

betty 


Jake 

poodle 


jake 


Sih 匕 e you Seated a -fv-esh 
^opy o( the daia, jakc 
>wois [Av\a((cdtd wheh you 
^hoihgcd bettys -field 




/ 



Betty 
pit bull 

s - - ^ 

betty 


Jake 

poodle 


jake 










the death of an object 


The stack vs. the heap: more on memory 

It’s not hard to understand how a struct differs from an object — you can make 
a fresh copy of a struct just using equals, which you can’t do with an object. But 
what’s really going on behind the scenes? 


Behind 
the Scenes 




Rcmcmbcv -； whch youv- 

p\rog\ram ； s \ruhhihg, the CLR 

,s adtively 

dalnr^ with the heap ； ahd 


The .NET CLR divides your data into two places in memory. You already know 
that objects live on the heap. It also keeps another part of memory called the 
stack to store all of the local variables you declare in your methods, and the 
parameters that you pass into those methods. You can think of the stack as a 
bunch of slots that you can stick values in. When a method gets called, the CLR 
adds more slots to the top of the stack. When it returns, its slots are removed. 

Evch -thoujh you ddrt 
3ssijh 3 s-t\rud*t "to 

an objedi variable, Here’s code that vou miaht 4-^ I: … . — This is where structs and local 

s-tv-uro a» 


The Code 


dhd objects 


Ww’s what the 

looks like a-fie\r these 

Here，s code that you might t wo | lhCS ^ ^ 
see in a program. 


The Stack 


V"Uh. 


Canine spot = new Canine("Spot ", "pug" 
Dog jake = new Dog("Jake ", "poodle"); 



variables hang out. 



Canine spot = new Canine ( n Spot ", "pug") 

Dog j ake = new Dog("Jake", "poodle"); 

Dog betty = j ake; 

vou dveate a s*brut*t—ov a” otiicv value 
• 1 “ I I ’’ I • 似 or>*to *tiic 

value m youv 切 


r any v 

variable—a ^ “slot” yb added or>*b 
s*tatk. TKa-t slo*t is a dopv o ? 七 he 


• _ 

l Dog betty jl 

I Dog jake J 


Canine spot = new Canine ( n Spot ", "pug") 
Dog j ake = new Dog("Jake", "poodle"); 
Dog betty = jake; 

SpeakThreeTimes(jake); 


public SpeakThreeTimes(Dog dog) 
int i. 

for (i = 0; i < 5; i++) 
dog.Speak(); 


W\\tY\ you dall a 
method) CLR 

pu*ts i*ts \oCd\ 
variables ov\ *tV)c 

I 七 -takes o^-f 

\n\\Cy\ rt’s doy\C. 
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don’t box me in 


VOAIT A MINUTB. VOHY X>0 I BVBN NBBD 
TO ICN^W THIS STUFF? I 6AM^ ANY 

O? IT DIRB6TUY, Rld^HT? 



0 



You … also use 七 
keyv/ovd *to see i-f ar\ 
object is a stvu^t o\r 
dr\y o-tiicv- value *byfc, 

七 ha 七 ’s bccr\ bo%cd ar\d 
pu*t or\ *tV^c V^ap. 


You definitely want to understand how a struct you copy by 
value is different from an object you copy by reference. 

There are times when you need to be able to write a method that can take either a 
value type or a reference type — perhaps a method that can work with either a Dog 
struct or a Canine object. If you find yourself in that situation, you can use the 
ob j ect keyword: 

public void WalkDogOrCanine(object getsWalked) { ... } 

If you send this method a struct, the struct gets boxed into a special object 
“wrapper” that allows it to live on the heap. While the wrapper’s on the heap, you 
can’t do much with the struct. You have to “unwrap” the struct to work with it. 
Luckily, all of this happens automatically when you set an object equal to a value type, 
or pass a value type into a method that expects an object. 

Here’s what the stack and heap look like after you create an object 
variable and set it equal to a Dog struct. 



TKc l/ValkPo^Ov-Ca^'mcO 

method takes av\ objcd*t 
vc-fcv-c^dc, so 七 he Po^ 
s*brud 七 >m3s bo%cd 
bc-fovc i*t v/ds passed 
m- 七 ” rt badk *to 3 
Po^ uhbo^cs *i*t. 


Dog sid = new Dog( M Sid' 
WalkDogOrCanine(sid); 

p 个 

•is 

av^t'wo topics 

of *tV>c da*ta ： oy\ 
jbhg statk, 3iy\A 
七 he dopy bo%cd 

Oi\ 


'husky"); 


OBJ 






Dog sid (boxed) 


❺ 


If you want to unbox the object, all you need to do is cast it to the right type, and 
it gets unboxed automatically. You can’t use the as keyword with value 
types, so you’ll need to cast to Doq. 

， sWU SO unless 

Dog happy = (Dog) getsWalked; 


I Dog happy Jk 


A-Ptcv- -this Ime 


； 巧&❾ “仏 


OBJ 



-嘯 ■$ 



a iliiv-d Coy 
the dataihra 
Y/^t\rudt 


” evrstwt dal led 
happy, yts 
its ovm slot OY\ 


Dog sid (boxed) 


s-tadk. 
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When a method is called, it looks for its arguments on the stack. 


the death of an object 


Beliind 
the ScenS 



The stack plays an important part in how the GLR runs your programs. One thing we take for granted is the fact 
that you can write a method that calls another method, which in turn calls another method. In fact, a method 
can call itself (which is called recursion). The stack is what gives your programs the ability to do that. 


Here are a couple of methods from 
a dog simulator program. They’re 
pretty simple: FeedDog () calls 
Eat (), which calls CheckBowl (). 


public double FeedDog(Canine dogToFeed, Bowl dogBowl) { 

double eaten = Eat(dogToFeed.MealSize, dogBowl); 
return eaten + .05D; // A little is always spilled 


\strt ： a _ 今广 

dalUk oUk ^od 
dcdiavatioy, s ? c6^»cs 

values \i y^ccds ； av. 
i\,t atW value ov 
i\\ai 70^ pass *m*to a wc 七 V\od 

you tall 


public void Eat(double mealSize, Bowl dogBowl) { 

dogBowl.Capacity -= mealSize; 

CheckBowl(dogBowl.Capacity); 


public void CheckBowl(double capacity) { 
if (capacity < 12.5D) { 

string message = M My bowl r s almost empty!"; 
Console.WriteLine(message); 


Here’s what the stack looks like as the 
FeedDog () method calls Eat (), 
which calls CheckBowl (), which 
calls Console . WriteLine () : 





C3 The FeedDog () 
method takes two 

parameters, a Canine 
reference and a Bowl 
reference. So when 
it’s called, the two 
arguments passed to it 
are on the stack. 


⑩ FeedDog () needs to 
pass two arguments to 
the Eat () method, so 
they’re pushed onto 
the stack as well. 


As the method calls 
pile up and the 
program goes deeper 
into methods that call 
methods that call other 
methods, the stack 
gets bigger and bigger. 


o When Console. 
WriteLine () exits, 
its arguments will 
be popped off of the 
stack. That way, Eat () 
can keep going as if 
nothing had happened. 
That’s why the stack is 
so useful! 


you are here ► 
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references upon request 


Use out parameters to make a 
method return more thaw owe value 





Speaking of parameters and arguments, there are a few more ways that you can get values in 
and out of your programs, and they all involve adding modifiers to your method declarations. 
One of the most common ways of doing this is by using the out modifier to specify an 
output parameter. Here’s how it works. Create a new Windows Forms application and add this 
empty method declaration to the form. Note the out modifiers on both parameters: 


A metkoct 
can return 


public int ReturnThreeValues (out double half, out int twice) 

{ 

return 1; 

} 

When you try to build your code, you’ll see two errors: the out parameter half must be 
assigned a value before control leaves the current method (and you’ll get an identical 
message for the twice parameter). Any time you use an out parameter, you always need 
to set it before the method returns — just like you always need to use a return statement if your 
method is declared with a return value. Here’s the whole method: 

Random random = new Random(); 


more 
tkan one 
value ty 
using out 
parameters* 




public int ReturnThreeValues (out double half, out int twice) 
int value = random.Next(1000); 
half = ((double)value) / 2; 

twice = value * 2; This wthodUceds *to set all d iis 

return value; out bc-Pov-c i*t rrtums; 

} o*thcV"y/isc, i*t won’t domfilc- 


Quick reminder: when 
Windows Forms programs 
call Console. WriteLine () 
it updates the IDE’s Output 
window (View^Output). 


Now that you’ve set the two out parameters, it compiles. So let’s use them. Add a button with this event handler: 


private void buttonl Click(object sender, EventArgs e) { 


int a; 
double b; 
int c; 

a = ReturnThreeValues(b. 
Console.WriteLine("value 


< 一 Did you how you didr/ 七 io b 

a^d t? You Aoy!{, y\ttA -feo ’mrtializjC a variable bc-fov-c 
you use i*t as b> 七 pavarwcicv-. 

={0}, half = {1}, double = {2}", a, b, c); 


Uh oh! There are more build errors: Argument 1 must be passed with the out 

keyword. Every time you call a method with an out parameter, you need to use the out 
keyword when you pass the argument to it. Here’s what that line should look like: 


a 


ReturnThreeValues (out b, out c); 


Now your program will build. When you run it, the ReturnThreeValues () methods 
sets the three values and returns all three of them: a gets the method’s return value, b gets 
the value returned by the half parameter, and c gets the value returned by twice. 




We’re using a 
Windows Forms 
application for this 
project because 
it’s easy for you to 
repeatedly click 
the buttons and 
see the console 
output in the 
Output window. 
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the death of an object 


Pass by reference using the ref modifier 


One thing you’ve seen over and over again is that every time you pass an int ， double, struct, 
or any other value type into a method, you’re passing a copy of that value to that method. There’s a 
name for that: pass by value, which means that the entire value of the argument is copied. 


But there’s another way to pass arguments into methods, and it’s called pass by reference. You can 
use the ref keyword to allow a method to work directly with the argument that’s passed to it. Just 
like the out modifier, you need to use ref when you declare the method and also when you call it. It 
doesn’t matter if it’s a value type or a reference type, either — any variable that you pass to a method’s 
ref parameter will be directly altered by that method. 




You can see how it works — add this method to your program: 

public void ModifyAnlntAndButton (ref int value, ref Button button) 


int i = value; 
i * = 5; 

value = i - 3; 
button = buttonl; 


this method sets value By\A 
pav-amc*tcv-s, v/ha*t its \rcally do'mj is 
the values o-f *thc <\ BY\d b 

variables m the bu*t*to^2 - ___Cli^kO method 

七 ha 七匕 a I led it. 

And add a button with this event handler to call the method: 


Ur>dcv- Kood, 
ou*t is jus*t 

like a vc-f av^ume 此 
oedeft that rt AotS)r!i 
r\ttA bo be assigned 
behove m*to 

dnd muS*t be 

dss'i^ed bc-fovc 七 he 

me 七 hod V-C*tuVir>S. 


private void button2_Click(object sender, 
int q = 100; 

Button b = buttonl; 

ModifyAnlntAndButton (ref q, ref b); 
Console.WriteLine( M q = {0}, b.Text = 


EventArgs e) { 


This pv-mts \ - 竹 7, b.T 作七二 butUJ” 
because the mcihod a^iually aliened -the 
and b variables. 


{1} n , q, b•Text); 


When button2_Click () calls the Modif yAnlntAndButton () method, it passes its q and b variables 
by reference. The Modif yAnlntAndButton () method works them just like any other variable. But since 
they were passed by reference, the method was actually updating the q and b variables all along, and not just a 
copy of them. So when the method exits, the q and b variables are updated with the modified value. 

Run the program and debug through it, adding a watch for the q and b variables to see how this works. 


Buil 七一 m value tyfcs ; TryRarscO mc-tKod uses out faramc-ters 

TheirVs a yrcai e d out built right m*to some <^f iht buil 七一 ih value types. There arc a 

lot of times that you’ll v/aht b> dohvc\rt a sVmg like ih-to a double. A^d there's a method io do 

c>^3d*tly double.Pa^5.^7 ) will \rc*tu\rh *thc double value 多 5 • 么 7. Burt double.Pav^eCScyz/’）will 七 Wow a 

Po\rmatE>cdcptioh. Sometimes that's c^adly v/Kat you wah 七 bu 七 other times you waht -to dhcdk i-P a sVmg 
Qh be parsed ih-to a value. That's wheire the T\ryPa\rscO method ih ： doublcTryParsc^'Vy^ out d) will 
v-c*tuv"h -false ahd sc*t d *to O, bu*t double.T\ryRa\rsc( u ^5.i7 w , ou*t d) v/ill \rc*tu\rh *tv~uc 3hd sc*t d *to Htn. 

Also, \rcmcmbc\r badk ih Chapter °{ y/hch VJC used a sy/i-tdh statcmcht to dohvert Spades ih-to Surb Spades? 
I/Vell, *thcv-c av~c s*ta*tid methods Ehum.Pa\rscO ahd Ehum.TVyRavseO -that do -the same 七 hih 少 -Pov- chums. 


you are here ► 





arguments optional 


Use optional parameters to set default values 

A lot of times, your methods will be called with the same arguments over and over again, but the 
method still needs the parameter because occasionally it changes. It would be useful if you could set a 
default value, so you only needed to specify the argument when calling the method if it was different. 

That’s exactly what optional parameters do. You can specify an optional parameter in a method 
declaration by using an equals sign followed by the default value for that parameter. You can have 
as many optional parameters as you want, but all of the optional parameters have to come after the 
required parameters. 

Here’s an example of a method that uses optional parameters to check if someone has a fever: 


void CheckTemperature(double temperature , double tooHigh = 99 . 5 , double tooLow = 96 . 5 ) 


if (temperature < tooHigh && temperature > tooLow) 
Console.WriteLine("Feeling good !")； 

else 


Optional have dc-Paul-t 

values spcdi-Picd m -the dedavatiem. 


Console. WriteLine ("Uh-oh -- better see a doctor !’，）； 


This method has two optional parameters: tooHigh has a default value of 99.5, and tooLow has 
a default value of 96.5. Galling CheckTemperature () with one argument uses default values for 
both tooHigh and tooLow. If you call it with two arguments, it will use the second argument for the 
value of tooHigh, but still use the default value for tooLow. You can specify all three arguments to 
pass values for all three parameters. 



There’s another option as well. If you want to use some (but not all) of the default values, you can use 
named arguments to pass values for just those parameters that you want to pass. All you need to 
do is give the name of each parameter followed by a colon and its values. If you use more than one 
named argument, make sure you separate them with commas, just like any other argument. 

Add the CheckTemperature () method to your form, and then add a button with the following 
event handler. Debug through it to make sure you understand exactly how this works: 

private void button3_Click(object sender, EventArgs e) 

{ 

// Those values are fine for your average person 
CheckTemperature(101.3); 


// A dog * s temperature should be between 100.5 and 102.5 Fahrenheit 
CheckTemperature(101.3, 102.5, 100.5); 


// Bob's temperature is always 
CheckTemperature(96.2, tooLow : 


a little low, so set tooLow to 95.5 
95.5); 


餐 


Use optional 
parameters 
and namect 
arguments 
wken you 
want your 
metkocts to 
kave default 
values. 
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the death of an object 


Use nullable types when you need wowexistewt values 

In a lot of projects earlier in the book, you used null to indicate that there is no value. That’s very 
typical: you can use null to indicate that a variable, field, or property is empty, and you can check 
to see if it’s equal to null, which means that it doesn’t have a value. But for structs (and ints, 
booleans, enums, and other value types), you can’t set them to null. That means these statements: 

bool myBool = null; 

DateTime myDate = null; 

will cause errors when you try to compile! So how do you indicate an empty value for these types? 


Batk CKapicv- II, you 
used Pa*tcT»mc.Mm\/aluc 
•to u da*tc y>o*t scV 
•m Ma^a^cv 

app. Kullaklc<Pa*bcTimc> 

yfould make bo*tK youv- 
todt av\A scvial'iz^d 

)<ML -files casicv *fco 
v-cad- 


Let’s say your program needs to work with a date and time value. Normally you’d use a 
DateTime variable. But what if that variable doesn’t always have a value? That’s where nullable 
types comes in really handy. All you need to do is add a question mark (?) to the end of any value 
type, and it becomes a nullable type that you can set to null. 

bool? myNulableBool = null; 

DateTime? myNullableDate = null; 

Every nullable type has a property called Value that gets or sets the value. A DateTime? will 
have a Value of type DateTime, an int? will have one of type int, etc. They’ll also have a 
property called HasValue that returns true if it’s not null. 


Nullable<DateTime> 

Value: DateTime 
HasValue: bool 


GetValueOrDefaultQ: DateTime 


You can always convert a value type to a nullable type: 

DateTime myDate = DateTime.Now; 

DateTime? myNullableDate = myDate; 

But you need to cast the nullable type in order to assign it back to a value type: 

myDate = (DateTime) myNullableDate; 

But you also get this handy Value property — it also returns the value: 

myDate = myNullableDate.Value; 



Nullablc<T> is a 

lc*U you s*tov-c a 
value -type OR a m\\ value. 
Wtvt av-C some of 
me 七 hods dr>d pvofcv-tics 
OY\ Kullablc<Pa*tcT*irwc>. 


If HasValue is false, the Value property will throw an 工 nvalidOperationException ， 
and so will the cast (because that cast is equivalent to using the Value property). 


Xiic «UACstior\ m 3 vk T? is alias -fov* Null 3 blc<T> 

you add a 呼 sW ^ to … 士切 K 临 ••气 饮虹 —1 ?々 
Nullable<T> sW*t (Nullable<m*t> Nullable<ae6r,al>). ^ w 说铷十 yourself add a Nullablc<PateT e ^ 

—*to a ? r 。 产个七 a o, *，i a,d add a ^ ^ m 七'巧 了 ^ . 

dUPlaved m ^ …如 IDE. n “扣 a, a ,as, a,d \U ,oi , 十七 ,?:; vc 

Jou, w. Hove, you, ove, a,y ^11 see Wlates -to a sWi called SysWM 兑 


m-tPavscO a^d rntTv-yPavscO avc r^c^bcvs o-f i\\\s s*bn^*t 


int value; 
struct System^Itvt32 
Represents a 32-bit signed integer. 

Take a ^ a,d do ^ ^ ^ %es at ^ ^ a，e aliases 

‘ U sbr\^ «s a dass dallcd SyW.S 饫 ” d a a value - 






taste the robust flavor 



IS! 7' 


Nullable types help you make your programs more robust 


Users do all sorts of crazy things. You think you know how people will use a program you’re 
writing, but then someone clicks buttons in an unexpected order, or enters 256 spaces in a 
textbox, or uses the Windows Task Manager to quit your program halfway through writing 
data to a file, and suddenly it’s popping up all manner of errors. Remember in Chapter 12 
when we talked about how a program that can gracefully handle badly formatted, unexpected, 
or just plain bizarre input is called robust? When you’re processing raw input from your 
users, nullable types can be very useful in making your programs more robust. Now see for 
yourself. Create a new console application and add this Robust Guy class to it: 


l/Vhch you ^dd Robus-t^uy ； s 
ToS-tv-ih^O method, take 

3 look the IhtdliSchSc 
wihdow y/hch you cv\icv 

Bi\rthdayValuc. 

the l/aluc f>\ropcv-ty is a 
Pa-tcTimc, youll see a\\ the 
usual DatcTirnc 


class RobustGuy { 

public DateTime? Birthday { get; private set; 
public int? Height { get; private set; } 


the ToLohgDatcStv-ihgO method io 

it h> a kmah-v-cadablc stv-i^a. 


PatcTiwc 
•mi Tv-yPavscO 
methods xO 

d.oy\vcv-*b 七 he 

usev 

values. 


public RobustGuy(string birthday, string height) { 
DateTime tempDate; 

if (DateTime•TryParse(birthday, out tempDate)) 
^ Birthday = tempDate; 

else 

Birthday = null; 


int templnt; 

if (int•TryParse(height, out templnt)) 
Height = templnt; 

else 

Height = null; 


|-f i\\t usev- 
cy\*bcv-cd ^av-ba^Cj 

i\\t Kullablc 

七 YF s … 0 灼七 
have values, so 〆 
ttas\/alucO 
wc-t^ods Will 

V-C*tuV"\r\ i 


public override string ToString() { 

string description; 
if (Birthday.HasValue) 

description = ，'工 was born on 

l) else 

description = ，'工 don't know my birthday 
if (Height.HasValue) 

^ description +=" 

else 

description +=" 
return description; 


^ Ticks 
^ TimeOfDay 
y ToBinary 
4 TofileTime 
'■4 ToFileTimeUtc 
V ToLocalTime 


ToLEmgiDateStrirtg 


^ ToLo n gT i m eStri n g 
To 0 AD ate 

V ToSh o rtD ateStri n g 

V ToSh o rtT i rri eStri n g 
ToString 

V ToUniversalTirrie 
^ Year 







+ Birthday.Value.ToLongDateString() 


and I'm 


Height 


inches tall 


and 工 don't know my height' 


Tiry v/i-th 七 he 

oihev DaicTimc rweihods 
七 ha 七 siari Wi-th u To w -to 
see how 七 hey a-P-Pcdi youv- 
ou-tpui. 
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And here’s the Main ( ) method for the program. It uses Console . ReadLine () to get input from the user: 

static void Main(string[] args) { 

Console . Write ( "Enter birthday : ，'）； 
string birthday = Console.ReadLine(); 

Console.Write("Enter height in inches : "); 
string height = Console.ReadLine(); 

RobustGuy guy = new RobustGuy(birthday, height); 

Console.WriteLine(guy.ToString()); 

Console.ReadKey(); 

} Co^soIc.RcadL'mcO lc*ts the usev- 

m*to the do 灼 sole wmdow. "the usev hits 

Chapter 13 i*t v-c*tuv-^s *thc as a st\rm 沴 


When you run the program ， 
see what happens when you 
enter different values for dates. 
DateTime. TryParse () can figure 
out a lot of them. When you 
enter a date it can’t parse，the 
RobustGuy 5 s Birthday property 
will have no value. 











the death of an object 



Paa] Puzzjc 

Your job is to take snippets from the 
pool and place them into the blank 
lines in the code. You may use 
the same snippet more than once, 
and you won’t need to use all the 
snippets. Your goal is to make 
the code write this output to the 
console when a new instance of the 
Faucet class is created: 


public class Faucet { 
public Faucet() { 

Table wine = new Table(); 
Hinge book = new Hinge(); 
wine.Set(book); 
book.Set(wine); 
wine.Lamp(10); 

book.garden.Lamp("back in"); 
book.bulb *= 2; 
wine.Lamp("minutes"); 
wine.Lamp(book); 


Output when you create a 
new Faucet object: 



public _ Table { 

public string stairs; 
public Hinge floor; 
public void Set (Hinge b) { 
floor = b; 

} 

public void Lamp(object oil) { 

if (oil _ int) 

_. bulb = (int)oil; 

else if (oil _ string) 

stairs = (string)oil; 

else if (oil _ Hinge) { 

_ vine = oil_; 

Console.WriteLine(vine.Table() 

+ " " + _.bulb + " " + stairs); 


public _ Hinge { 

public int bulb; 
public Table garden; 
public void Set (Table a) { 
garden = a; 

} 

public string Table () { 


return _. stairs; 

Bonus points: Circle the lines 
where boxing happens. 


Note: Each 
thing from 
the pool can 
be used more 
than once. 



Aiwers on pa^e 648. 

you are here ► 


► 
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structs are safe 


OK, back up a minute. Why do I 
care about the stack? 

A! Because understanding the difference 
between the stack and the heap helps you 
keep your reference types and value types 
straight. It’s easy to forget that structs and 
objects work very differently—when you use 
the equals sign with both of them, they look 
really similar. Having some idea of how .NET 
and the CLR handle things under the hood 
helps you understand why reference and 
value types are different. 



Dumb Questi 9 ns 

I get how you get a fresh copy of 
a struct when you set one struct variable 
equal to another one. But why is that 
useful to me? 

\ One place that’s really helpful is with 
encapsulation. Take a look at this familiar 
code from a class that knows its location: 

protected Point location; 
public Point Location { 
get { return location; } 


And boxing? Why is that important 
to me? 

Because you need to know when 
things end up on the stack, and you need 
to know when data’s being copied back and 
forth. Boxing takes extra memory and more 
time. When you’re only doing it a few times 
(or a few hundred times) in your program, 
then you won’t notice the difference. But let’s 
say you’re writing a program that does the 
same thing over and over again, millions of 
times a second. That’s not too far-fetched: 
you’ll build an arcade game at the end of 
the book that could do many calculations 
per second. If you find that your program’s 
taking up more and more memory, or going 
slower and slower, then it’s possible that you 
can make it more efficient by avoiding boxing 
in the part of the program that repeats. 


cr^terpen your pencil 

"Tl-v \ r* I r 1 r* I 


If Point were a class, then this would be 
terrible encapsulation. It wouldn’t matter that 
location is private, because you made 
a public read-only property that returns a 
reference to it, so any other object would be 
able to access it. 

Lucky for us, Point is actually a struct. 
And that means that the public Location 
property returns a fresh copy of the point. 

The object that uses it can do whatever it 
wants to that copy—none of those changes 
will make it to the private location field. 

个 

6io batk b> label 

lr 0 州 今 . U^dc^r -tKc Kood, 

You 會 t md'ircttlY ?om-b a^d 

lodatio^s, means Codt v/as 

settma sbrui values (cvc^ .A* Y ou 
出心’七 dctlav-c 七 divcttb/). 


This method is supposed to kill a Clone object, but it 
doesn’t work. Why not? 

private void SetCloneToNull(Clone clone) 
clone = null; 


How do I know whether to use a 
struct or a class? 

A! Most of the time, programmers use 
classes. Structs have a lot of limitations that 
can really make it hard to work with them for 
large jobs. They don’t support inheritance or 
abstraction, and only limited polymorphism, 
and you already know how important those 
things are for writing code. 

Where structs come in really handy is if you 
have a small, limited type of data that you 
need to work with repeatedly. Rectangles 
and points are good examples—there's not 
much you’ll do with them, but you’ll use 
them over and over again. Structs tend to be 
relatively small and limited in scope. If you 
find that you have a small chunk of a few 
different kinds of data that you want to store 
in a field in a class or pass to a method as a 
parameter, that’s probably a good candidate 
for a struct. But if the way you use the struct 
will cause it to be boxed most of the time, so 
you may be better off with a class. 


A struct can te very 
valuatle wken you 
want to add good 
encapsulation to 
your class，because a 
react-only property 
tkat returns a struct 
atwa” makes a 
fresli copy oi it. 

Pop 'ui，, ho-tsho-t/ 

Ahswc\r ； s oh page Z 午 2. 
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the death of an object 


"Captam" Amazmg...not so much 


With all this talk of boxing, you should have a pretty good idea 
of what was going on with the less-powerful, more-tired Captain 
Amazing. In fact, it wasn’t Captain Amazing at all, but a boxed struct: 



❶ Structs can't inherit from classes. 


VS. 


❶ You 



Thats ov\t bij 
adva^-tajc ok s-tv-u^-b 
value 


•types)—you 6 扣 easily 
make topics of 



can't create a fresh copy of an object. 


No wonder the Captain’s superpowers seemed a When you set one object variable equal to another, 

little weak! He didn’t get any inherited behavior. you’re copying a reference to the same variable. 



Structs are copied by value. 

This is one of the most useful things about them. 


❺ You can use the as keyword with an object. 

Objects allow for polymorphism by allowing an object 


It’s especially useful for encapsulation. 


to function as any of the objects it inherits from. 

O^t imfoviarrt fomi ： you dar> use ^ keyv/o^rd -to 
tKcdk i-f d s*tvu£.*t ir«plcrwCr>*ts 3^ v/Kitii is one — ^ 

^oly^ov^Kism Aa 七 s*tvu£.'ts do su 代 ov* 七 . 





BACK AT THB UAB 


I T_K IVE FOUND A WAY TO GlVB 
POWERS TO A NORMAL CITIZEN! 




, 5 ^ 


you are here ► 
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Extension methods add new 
behavior to EXISTING classes 


Remember {\\t sealed modi-f»CV" 

7 ? l-t's you 
SC*t ^ 3 £>ld^S ^ 3 ^ "t tc 

c%*tc\r\dicdi- 



Sometimes you need to extend a class that you can’t inherit from, like a sealed class (a lot of the .NET classes 
are sealed, so you can’t inherit from them). And G# gives you a flexible tool for that: extension methods. 
When you add a class with extension methods to your project, it adds new methods that appear on classes 
that already exist. All you have to do is create a static class, and add a static method that accepts an instance 
of the class as its first parameter using the this keyword. 


So let’s say you’ve got a sealed Or dinar yHuman class (remember, that means you can’t extend it 



sealed class OrdinaryHuman 
private int age; 
int weight; 


public OrdinaryHuman(int weight) 
this.weight = weight; 

} 


The Ovd'mavytturwa^ dlass is 
sealed ； so i*t be subclassed- 
Bu 七 what i-f >/c war>*t *to add a 
method *to i*t? 


public void GoToWork() 
public void PayBills() 


^ code to go to work ★, 
* code to pay bills */ 


You use extehsioh method 
by sp^i+yi h g -the -fivs-t 

usihg the u -this w 

keywovd. 

wc io cxtXd the 

dass, the Usi 

p V" metev- this iVdihdV-yttur^h. 

Himanjy 


The SuperSoldierSerum method adds an extension method to Ordinary 

static class SuperSoldierSerum 

public static string BreakWalls(this OrdinaryHuman h, double wallDensity) 
return ( n I broke through a wall of " + wallDensity + " density .")； 

} Extchsioh methods «Hrc d! 


u-A^cnsion rwccnoaS dV*C dlw^ys 

s*ta 七 methods, ahd they have 
■to live ih s-ta-tid dloisses. 


As soon as the Super Soldier Serum class is added to the project, 
OrdinaryHuman gets a BreakWalls method. So now a form can use it: 

static void Main(string[] args){ 

OrdinaryHuman steve = new OrdinaryHuman(185); 
Console.WriteLine(steve.BreakWalls(89.2)); 



- c%^arpen your pencil 

Solution 


l/Vheh -the p\rog\rarw dh 

o-P the 0\rd*m«Hrytturwah 
dass, it aucss -the Bv-caklVillsO 
method di\rc^ly—as loh^ ds i-t has 
a^dcss -to the SupcvSoldiC\rSc\rurw dlolss. 

与。 ahead, t^it out/ Crtait 
匕 cmsole applidoitioh add ihe two 
dldsscs 3hd "the /VJaihO method *to i*t. 
Debug m-to the B\rcaklVallsO method 
see what’s gomg oh. 


This method is supposed to kill a Clone object, but it doesn’t work. Why not? 


private void SetCloneToNull(Clone clone) 
clone = null; 


So i\\t c\ov\t 

is \uS*t OY\ so , } 

**t *to v^ull docsn *t do , 

*bo V^cap. AH this method docs is srt its oym para^c*tcr *to hull ； but *tha*t para^e*tcv- s just a 

\ rc-fcrchdc bo a Clone. |*t’s like a label oy\ dh objed*t dhd pccl'm^ i*t o-f-f a^a'm. 


sc 

a 
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the death of an object 


tJiereiare no o 

Dumb Questi9ns 


Tell me again why I wouldn’t add the new methods I 
need directly to my class code, instead of using extensions? 

You could do that, and you probably should if you’re just 
talking about adding a method to one class. Extension methods 
should be used pretty sparingly, and only in cases where you 
absolutely can’t change the class you’re working with for some 
reason (like it’s part of the .NET Framework or another third party). 
Where extension methods really become powerful is when you 
need to extend the behavior of something you would^t normally 
have access to, like a type or an object that comes for free with 
the .NET Framework or another library. 

Why use extension methods at all? Why not just extend 
the class with inheritance? 


If you can extend the class, then you’ll usually end up doing 
that—extension methods aren’t meant to be a replacement for 
inheritance. But they come in really handy when you’ve got classes 
that you can’t extend. With extension methods, you can change the 
behavior of whole groups of objects, and even add functionality to 
some of the most basic classes in the .NET Framework. 

Extending a class gives you new behavior, but requires that you 
use the new subclass if you want to use that new behavior. 



Does my extension method affect all instances of a 
class, or just a certain instance of the class? 

A! It will affect all instances of a class that you extend. In 
fact, once you’ve created an extension method, the new method 
will show up in your IDE alongside the extended class’s normal 
methods. 




夕 吣工 ITi SO USB 

BXTBNSI^M METHODS JO ADD M5W 
BBNAVI^R JO 0\s\B O? THB BUIUT-IN 
.N6T 6UASSBS ； Rld^NT? 


Ont more *to \rcmcw\bc\r about 
w\C*t^ods ： you doir\ 

d£.£.css *to ayiy s 

by dy\ t%itv\s\ov\ method, so 

iVs still 3s ou*tsidc\rf 


The dombmatio^ By\ 
mtev-fade plus c>c*tc^sioW 
methods tBv\ be vcv-y usc-ful 
because it lets you add 
bchaviov- -to a^y dlass -that 
implements the 



Exactly! There are some classes that you can’t inherit from. 

Pop open any project, add a class, and try typing this: 
class x : string { } 

Try to compile your code — the IDE will give you an error. The reason is that 
some .NET classes are sealed, which means that you can’t inherit from them. 
(You can do this with your own classes, too! Just add the sealed keyword to 
your class after the public access modifier, and no other class will be allowed to 
inherit from it.) Extension methods give you a way to extend it, even if you can’t 
inherit from it. 

But that’s not all you can do with extension methods. In addition to extending 
classes, you can also extend interfaces. All you have to do is use an interface 
name in place of the class, after the this keyword in the extension method’s 
first parameter. When you do, the extension method is added to every class 
that implements that interface. You’ll learn all about LINQjn the next 
chapter — while you’re learning, one thing to keep in mind is that it was built 
entirely with extension methods, extending the IEnumerable<T> interface. 


you are here ► 
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better faster stronger 


Extending a fundamental type: string 

You don’t often get to change the behavior of a language’s most fundamental types, 
like strings. But with extension methods, you can do just that! Create a new project, 
and add a file called HumanExtensions.es. It doesn’t matter what kind of project you 
create — you’ll be using the IDE to explore how extension methods work. 


o 



PUT ALL O? y^UE BXTBMSI^N METHODS IN A SBPAEATB NAMBSPACB- 

It’s a good idea to keep all of your extensions in a different namespace than the rest of your 
code. That way, you won’t have trouble finding them for use in other programs. Set up a 
static class for your method to live in, too. a sepav-ate r>amesf>ade is a ^ood 

^ -- 灼 al bool 


namespace MyExtensions { 

public static class HumanExtensions 


❹ 


The dass you\r method is 

dc-fmcd \y\ rwus-t be 


XKc w»c*t^od 

be static W 


DEBATE THE STATIC BXTBMSI^N METHOD, AMD DEFINE ITS FIEST 
PAEAMBTBE AS THIS AMD THEM THE TYPE VOU f ^B BXTeMDIN^. 

The two main things you need to know when you declare an extension method are that 

the method needs to be static and it takes the class it’s extending as its first parameter, "this 心叫 ” s ^y s 

眯 US 七 - -- C ^hdih 9 S^j h g ^| ass 

^ - ^public static bool IsDistressCall (this string s) { 


❺ 


PUT THE COl>B TO BVAUUATB THE STRING IN THE METHOD. 

public static class HumanExtensions { 

. public static bool IsDistressCall (this string s) { 

» ou Wirt 七 his dass -to be if (s • Contains ( "Help ! ’▼)) 

SCCtsscd by Code m -the return true; 

othe\r so make else ^^ This dhe 匕 ks 七 he (or a dev-ta'm value...someih'm3 

suve you rwakc it public/ return false; dc-Pmiidy v\oi *m 七 he dc-fauli siv-*mg dass. 


Q use VOU^ NEW Ist>ismessCAUuO BXTBMSI^N METHOD. 

Go to any other class and add using MyExtensions ; to the top. Now, when you use a string, you get 
the extension methods for free. You can see this for yourself by typing the name of a string variable and a period: 

static void Main ( string [ ] args) 


} 


string message 
message. 

© IndexOf 

A 、 I © IndexOfAny 

s sooy\ as you type 

the dot the IDE 0 lnsert 

pops up a helper 
window with dll of 
stvmjs methods … 一 
mdudii^ youv* 
c^-tchsio^ method- 


IsDistressCaillli 


Clones are wreaking havoc at the factory. Help!"! 

▲ Co^i ou-t Imc, a^d 

-e-tw w,ll d-.sa ?? ea, W 

i\,t U*tcll'»Sc^c v/mdo 从 

1^-tdliSc^sc y/mdov/ -tells 
you -that its av\ c^tc^sio^. 



(extension) bool string.IsDistressCallO 


IsNormalized 
Join<> 
Lasto 

© La&tlndexOf 
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This toy example just shows you the syntax 
of extension methods. To get a real sense 
of how useful they are, just wait until the 
next chapter. It’s all about LINQ，which is 
implemented entirely with extension methods. 















the death of an object 




Extension Magnets 

Arrange the magnets to produce this output: 

a buck begets more bucks 


public static class Margin { 


public static void Sendlt 


using Upside; 
namespace Sideways { 


class Program { 


public static string ToPrice 



} 


Console.ReadKey ()； 

} ' 

} 




J 





s.Sendlt(); 


3; 


bool b = true; 


Console.Write(s); 


if (b == true) 
return M be M ; 


public static string Green 


if (n == 1) 

return "a buck 




.Green() .Sendlt(); 



(this string s) { 

^^T^endXtOj 


static void Main(string[] args) { 


Sendlt ()； 


else 


return "gets 


string s = i.ToPrice(); 


you are here ► 
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Extension Magnets 


Your job was to arrange the magnets to produce this output: 
a buck begets more bucks 


TVic U\>s'»dc 

V^ds i\\t t^itv\s\oY\s. T\\t 

Sidcv/ays y\amcs\>atc Vias 
i\\t 




The Mav-J'm dlass wt ⑶ db "the s-tv-'mj by 

a method dalled Sc^dltO -that 

y/V-i*tcs the s*tvmg *to the to^solc, By\A H 

c%*tc^ds 'm*t by addm^ a method dallcd 
ToPv-idcO *tha*t v-c*tu\r^s w a butk w i-P the 

ecyual *to I, or u mov-c budks^ i-p its 朽 o*t. 


pu 

Lblic static class Margin { 

1 〆 


I 

Public static void Sendlt 

(this string s) { | 



Console.Write(s); 

「 



The ev)b"y pom 七 method 

uses *thc c%*tcir>s*ioy>s *tha*t 
you added *m *thc Mav^m 
class. 


public static string ToPrice (this int n) 

if (n == 1) 

return M a buck 



using Upside; 
namespace Sideways { 

— - 

class Program { 


else 


static void Main(string[] args) { 


return ，’ more bucks M 


參 





string s 


.ToPrice(); 


public static string Green 

(this bool b) { 

| J 




return "gets 



丁 he ^\rCCh mctliod extends a 
bool—it \rctu\rhs the stvinj u bc ； 
i-P the bool is -t\ruc, a^d 
i-P its -false- 



bool b = true; L 


1 b. Green () . Sendlt () ; || 


b = false 

1 


b• Green () . Sendlt () ; || 


i = 3; | 


i.ToPrice() 

^SendI^)^J 
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RBS 

^UOwDO 


UJLT mS^RUBRO CLASS, BUT 
WOvj DO WB BRlNe SACK TWB CAPTAlU? 



^UNTVERSE# 

侧 mrnrn] 

Death was not the end! 


OBJEGTVILLE 


By Bucky Barnes 

UNIVERSE STAFF WRITER 


二 ai„ W — deseHali.es hi mse lf, mafees 一 — 一 ^ 

_th, Capf a rAmLTgTcoffirwas found em h ^ '° ° bjectville - La ^t 

left where his body should have been AnalvsH _ °吻 a Stran g e note 

— t fields 

ownM^fnl^ ^7 1126£，&0 -^ 

^d ； ^r^s 1 ;^r I0 • ,, s 。二。 

to his f ailed assault on Swindler ^ ^ ^ admit that P™r 

一。 一 

• see AMAZING on A-5 




jr 




\ 

/ 


Captain Amazing is back! 
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puzzle solution 



Paa] puzz]c 


Tk L—) sets 饮 n ouS 

如呼 ad ▲ 以， ^VV'u 
， V,aW objW • 呼 ^ 


public Struct Table { 

public string stairs; 
public Hinge floor; 
public void Set (Hinge b) 
floor = b; 


\Y\ ^ 


Output when you create a 
new Faucet object: 
back in 20 minutes 

public class Faucet { 


public Faucet() { 

Table wine = new Table(); 
Hinge book = new Hinge(); 
wine.Set(book); 
book.Set(wine); 



public void Lamp(object oil) 


line . Lamp (10) ; 


book. 
book.bulb 


garden . Lamp ( "back 
= 2 ; 



wine.Lamp(book); 

} x 
} ttcvc s why Tabic has -to be a s-tv-u^-t. |-f i-t 

v/cire a dass, -thch wihC would poih-t -to the 
saw object as b 。。 !^ 此 de 〜 would 

Quse this "to ovc\rw\ri-tc the w badk *m W s-tyihg. 

Bonus question: Circle the 
lines where boxing happens. 

Smdc i\\t Lar^pO rwc-tiiod takes av\ objed-t 
pav-amc*tcv-, bo^m^ au*tor«a*titally 
y/Kcr> rt's passed av\ *m*t ov d sbr'\Y\^ 



if (oil is int) 


floor, bulb 


(int)oil; 


else if (oil is string) 


/*P you pass s 
s*tv-ihg io La^y, 
it sets -the S-bivs 
y "to y/ha"tcvcv 

I is i h -tha-t s-tv-ihg. 


stairs = (string)oil; 
else if (oil is Hinge) • 


Hinge vine = oil _as Hinge ； 

Console.WriteLine(vine.Table() 



floor .bulb + 


+ stairs); 


as 

keyv^ovd ovA^j … ovks W\{\\ 
classes, r\o*t s*bru 匕 * U- 


public class Hinge { 
public int bulb; 
public Table garden 


public void Set (Table a) 



garden 


a 


Both ttmjc Tabic 
have a Sc*tO method, 
ftnr^c’s SctO sets 
i*b Tabic -field called 
6\ardtY\, a^d Tables 
Se 七 0 method sets 
its ttmjc -field 匕 ailed 
Floor. 


public string Table () { 

return garden .stairs 
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參 Get control of your data 


SO IF YOU TAKE THE FISST FEOM THIS 

AETI6UB, AND THE SBC^hJt> W^ED IN THAT UST, AND 
ADD IT TO THE FIFTH W^ED ^VBE HBEB—Y^U 夕 ET 
SSCS5T MBSSA^BS FEOM THE ^VBRMMBMTi 




如 Da 








IW 


m 




FU.I- 


w 


It’s a data-driven world.• .it’s good to know how to live in it. 

Gone are the days when you could program for days, even weeks, without dealing with 
loads of data. Today, everything is about data. And that’s where LINQ comes in. LINQ 
not only lets you query data in a simple, intuitive way, but it lets you group data and 
merge data from different data sources. And once you’ve wrangled your data into 
manageable chunks, your Windows Store apps have controls for navigating data that 
let your users navigate, explore, and even zoom into the details. 


this is a new chapter 
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an amazing fan 


Jimmy's a Captain Amazing supcr-faw... 

Meet Jimmy，one of the most prolific collectors of Captain Amazing 
comics, graphic novels, and paraphernalia. He knows all the Captain trivia, 
he’s got props from all the movies, and he’s got a comic collection that can 
only be described as, well, amazing. 




6HBC1C OUT THIS LIMITED- 
SBRIBS CAPTAIN AMAZING 
MU& THE SBCObil> 

AMNUAU A/AAZlN f CON SI^MBD 
BY THE ACTUAL PBM6IUBR AMD 

INlKSEi 


Uai，s 叫吨 -the a^ a \ sd 

柊咖 the flop Ca^ 

TV show ^ ^ S 吓 twb 饮 

thv 0 “ 3 h Wovcmbcir IfB. fWd Jimmy 

cveh get his h^hds oh thai stu-Pf? 


650 Chapter 14 







querying data and building apps with LINQ 


.but his collections all over the place 






Jimmy may be passionate, but he’s not exactly organized. He’s trying 
to keep track of the most prized “crown jewel” comics of his collection, 
but he needs help. Gan you build Jimmy an app to manage his comics? 


CAPmiN AMAZING 

o™hS§^ct 


s —— w j 一： 

一 - _ 
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to^Cc 

v/\r'i*bcvs- 




























































































LINQ to the rescue 


LINQ caw pull data from multiple sources 

LINQ to the rescue! LINQ (or Language Integrated Query) is a 
flexible feature of G# that lets you write queries to pull data out 
of a collection. But LINQalso lets you work with more than just 
collections — in fact, you can use it to query any object that implements the 
工 Enumerable<T> interface. 


So let’s use LINQ to help Jimmy get a handle on his comic book collection. 


^ the b^s 

weire ih a ^oll^ti 0h . 


d used m d bcc simula*tov *to 

aroyA? a^d ovdev bees by state- Tiic 
simula-tov- is pa\rt ^Pl+ PVf you 

w do^load Head M Labs wbs •• 七 e. 


var beeGroups = 

from bee in world.Bees 
group bee by bee.Currentstate 
into beeGroup 
orderby beeGroup.Key 
select beeGroup; 






T\\t 


LINQ^ works with pretty much every kind of data source you could 
use in .NET. Your code needs a using System. Linq; line at the 
top of your file, but that’s it. Even better, the IDE automatically puts 
a reference to LINQ in the header of the class files it creates. 


,y^oc about LIK^ 

database o, ><ML ⑽ H 
bees or or else- 
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querying data and building apps with LINQ 


•NET collections are already set up for LINQ 


All of the collection types in .NET implement the IEnumerable<T> interface, 
which you learned about in Chapter 8. But take a minute to get a refresher: type 

System. Collections . Generic. IEnumerable<int> into your IDE 
window, right-click on the line, and select Go To Definition (or press F12). You’ll 
see that the 工 Enumerable interface defines a GetEnumerator () method: 


碟 5 £驗 


namespace System.Collections.Generic { 
interface IEnumerable<T> : IEnumerable { 



// Summary : 

// Returns an enumerator that iterates through the collection. 

// 

// Returns : 

// A System•Collections•Generic •工 Enumerator<T> that can be 

// used to iterate through the collection. 

工 Enumerator<T> GetEnumerator(); 




This method requires your object to define a way to move 
through the elements in it, one element at a time. That’s 
all LINQ requires as a prerequisite. If you can move 
through a list of data, item by item, then you can implement 
工 Enumerable<T>, and LINQcan query the collection. 


TV^'is is i\\t only i-atM 

toWteho^ tw»s method. You tould 

tvca-tc VoiA^r k'md object i—erner 七 cd 

|^umcrablc<T> boo.^d •»? you a*.a, you touia use 

you\r object 


Beliind 
the Scenes 



LINQ uses extension methods to let you query, sort, and update data. Check it out 


for yourself. Create an int array called linqtest, put some numbers in the array, and 
then type this line of code (don’t worry, you’ll learn what it does in a minute): 

工 Enumerable<int> result = from i in linqtest where i < 3 select i; 

Now comment out the using System. Linq; line up in the header of the file you’ve 
created. When you try to rebuild the solution, you’ll see that this line doesn’t compile ^ 
anymore. The methods you’re calling when you use LINQ^ are just extension methods 
that are being used to extend the array. 


Wow you see why 
CX-tchsioh methods 
weve so impov-tah-t ih 

Chaptcir IZ.Mcy Ui 

•WEt “d you) add all 

kihds of 匕 ool bchdviov~ 

"to cxis-tihg types. 
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some queries are simple 


LINQ makes queries easy 

Here’s a simple example of LINQ syntax. It selects all the numbers in an 
int array that are under 37 and puts those numbers in ascending order. It 
does that using four clauses that tell it what object to query, what criteria to 
use to determine which of its members to select, how to sort the results, and 
how the results should be returned. 


int[] values 


var result = from v in values 


new int[] {0, 12, 44, 36, 92, 54, 13, 8}, 

This assijhs the IcUcir V io stahd m -for 
o( -the a\r\rciy values ih -the <\ucvy. So v 

is O, then /Z, "then 午午，七 lieh 3 厶 … d It’s 

This L|N<$ *\uc\ry has V where V < 37 < — 、 ed ， Venable . 

W dlauscs ： iht 柊 。 m ) Th,S sa Y s ^ sclcd ： 從 h V/ m 七 he 

dlause, a where dlause, , 齡 ay 七 ha 七 is I 议七‘订 

o^y .Use, a,d Ue ) orderby v ^ 

st\td dlausc. / "Thch, put those values i h o\rdtY 

Select V ； lowest -to highest). 

|-f you’ve used S6^L bc-fovc, \i ^ay 

foreach(int i in result) seem y/civd -to put at 

•bKc ⑼ d, bu 七 tKats Ko>w thmgs 

Console. Write (" { 0 } ", i) ; “ m L l ⑽. 

Now you^a^ i*tcv-a*tc tWo — 如 

Console. ReadKey () ; vc-tuv^cd -to 

pvm 七 output 




vav- 

^ *,s a ㈣ 赠 d 如 Uells 怅 6—1 吖 〆 a rable ^ 

you W,ld you, soWiL k 破 k” 

v/rblv 

\y\ -b^c above, y/h ⑼ tliis Ime is tor^iled: 

•yg^ result = fjroiti v in values 

T\\t dompilev vepla^es Vrbh *tWis: 

IEnumerable<int> 

Ar,a V/W.le v/eVe or, subject o-f UtrUts U ，六:一 abouU: 

|E^^ablc<T> *.s UtrUt that ，。士 A lot 

v.a e%W.or, ^ods -that da |^ur,^able<T>, so you II see -bhat a lot. 
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Flip back to Chapter 8 to get a refresher on the IEnumerable<T> 
interface. Plus, you can read more about it in leftover #7 in the appendix. 








querying data and building apps with LINQ 


LINQ is simple, but your queries don’t have to be 

Jimmy just sold his start-up that sells apps in the Windows Store to a big investor, 
and wants to take some of his profits and buy the most rare and expensive issues 
of Captain Amazing that he can find. How can LINQ help him scour his data 
and figure out which comics are the most expensive? 

❶ Jimmy downloaded a list of Captain Amazing issues from a Captain Amazing fan page. He put them in a 
List<T> of Comic objects that have two fields, Name and Issue. 


class Comic { 

public string Name { get; set; } 
public int Issue { get; set; } 

} 

Jimmy used object initializers and a collection initializer to build his catalog: 


private static 工 Enumerable<Comic> BuildCatalog() 


return new List<Comic> 


r\o spedial vcasor\ 

七 is 
七 ‘ *to 你 ake it easy -to tall 
a cov\so\t affixations 
cr\*tvy method- 


We lc-P*t the 0 

o-f-f 

o( £.ollcd*tio^ 
Bv\d objedt 
'mi*tiali2jC\rs 
<Con\\t>, because 
you do^*t need cm. 


new Comic 
new Comic 
new Comic 
new Comic 
new Comic 
new Comic 
new Comic 
new Comic 



68 }, 


❺ 


Name = "Johnny America vs. the Pinko’，，Issue = 6 }, 

Name = "Rock and Roll (limited edition )", Issue = 19 }, 

Name = ’'Woman's Work ", Issue = 3 6 }, 

Name = "Hippie Madness (misprinted)，'，Issue = 57 
Name = "Revenge of the New Wave Freak (damaged)" 

Name = "Black Monday" , Issue = 7 4 } , 

Name = "Tribal Tattoo Madness" , Issue = 83 }, 

.Name = "The Death of an Object", Issue 二 97 }, 

}; Issue 养 7K Captain 

} Take a minute and flip to leftover #7 in the appendix to learn is taWtd w Bladk Monday . ； 

about a really useful bit of syntax that could come in handy 
here. This is a great opportunity to experiment! 

Luckily, there’s a thriving marketplace for Captain Amazing comics on Greg’s List, a website where people sell 
used comics. Jimmy knows that issue #57, “Hippie Madness,” was misprinted and that almost all of the run was 
destroyed by the publisher, and he found that a rare copy recently sold on Greg’s List for #13,525. After a few hours 
of searching, Jimmy was able to build a DictionaryO that mapped issue numbers to values. 


private static Dictionary<int, decimal 〉 GetPrices() 


return new Dictionary<int, decimal 〉 



{ 6, 

3600M }, 

RcrwCrwbcv 

{19, 

500M }, 

this syntax 

{36, 

650M }, 

■fov* ^ollc^tioh 

{57, 

13525M }, 

ihitiolliz^vs -Pov 

{68, 

250M }, 

didtioha\rics -Pv-orw 

{74, 

75M }, 

Chaptcv- 0? 

{83, 

25.75M }, 


{97, 

35.25M }, 


Issue 养弓 7 is wov-th 





Look closely at the LINQ query on 
page 654, then look at Jimmy’s 
methods on this page. What do 
you think he would put into a query 
to find the most expensive issues? 


you are here ► 
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it’s not sql 



Anatomy of a ^uery 


Jimmy could analyze his comic book data with one LINQquery. The where clause tells 
LINQwhich items from the collection should be included in the results. But that clause 
doesn’t have to be just a simple comparison. It can include any valid G# expression — like 
using the values dictionary to tell it to return only comics worth more than S500. And the 
or derby clause works the same way~we can tell LINQto order the comics by their value. r 

TKc L 陶 '叫 H ls 
ok\ct*b ou*t <^f *tV^c Vomits \\st, 
data rn values 


IEnumerable<Comic> comics = BuildCatalog() 



d\chov\a^ *b Atc\dc 一 A 

cWi 乙 s *to select. 


Dictionary<int r decimal> values = GetPrices() 

The -Pi^rs-t clause m ihc <\ucvy is -the -Pvom clause. This o^t tells 

"to ^uCV'Y "the dorv\ids "Bia 七七 1^ Cotri\C v/ill 

^ uscd ^ ^ "to spcdi-Py how -to brtai ea 乩 maividual 
or data \v\ the dollcdtio^. 


var mos tExpenslve 


rou 乙 d 的 


from qfimic in comics 


iTyo? where values [osmic,. Issue] > 500 

orderby values [comic .Issue] descending 


r 

Wo\ 


clause- 


Wc 匕 hose 
U domi^. W 


select comic 


4 

/ The ton\\t y/ds dc-f med m the -from 
dlduse spe 匕 i*fi 匕 ally so i 七 toM be used'm 
the y/hcv-c av\d ov-dc\rby clauses. 

foreach (Comic comic in mos tExpensive) 

Console.WriteLine( n {0} is worth {1:c} n 



o\rdc\rby 

\aAc any C : 


The whcv-c I 

clauses CBy\ mdude ANy 

so we ta 灼 use the 
values di^*tio^a\ry -to select 
only -those Com\Cs wo\rth 
more ^00, a^d wc t^Y\ 
so\rb the results so -the most 
oy\CS Con\t -fiv-s*b- 

l/Vhch you add u {l*d} w -to the 
1/Vvi-tcLihC output, 七 hat tdls it 
to pv'mt 七 he sedemd pavamciev 
•m the lodal duvvchdy -Povrwai- 


comic.Name, values[comic.Issue]) 


TV <\ucvv rth^Y\td i*b vcsults m*to an |Er\umcv-ablc<T> 
called mo 莊平給 We Tk sclcdt clause dticr^cs W 七 
^ocs tVic ^sults-smtc \i seized X Uc '叫 
vc*buV"r\cd Comi£. objct*bs* 



Output: 

Hippie Madness (misprinted) is worth $13,525.00 
Johnny America vs. the Pinko is worth $3,600.00 
Woman A s Work is worth $650.00 


We’re showing you 
each LINQ query in 
this chapter twice: 
first in a console app 
to help you see how it 
works, then in a larger 
Windows Store app 
so you can see how 
a LINQ query works 
in context — because 
your brain keeps 
track of things things 
better in context! 
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I D^M X T BUY THIS- I KbiOVJ 
SQL AURBADYi ISI^T WRITING A 
UIN^? 6?UBRY JUST UKB WRITING SQL? 


Po^*t y/ovvy i-f you vc 
r\cvcv* used S($L—you 
dor / 七 v\ttA bo kr\oy/ 

… 3 about i*t *to 
y/ovk y/i*tV^ L|N^- Bu*t i-f 
vouVc tuvious, diic^k ou*t 
u ttcad Fivs-b S 公 L ” 


LINQ may look like SQL, but it doesn’t work like SQL. 

If you’ve done a lot of work with SQL, it may be tempting to dismiss 
all this LINQ stuff as intuitive and obvious — and you wouldn’t be alone, 
because a lot of developers make that mistake. It’s true that LINQ 
uses the select, from, where, descending, and join keywords, 
which are borrowed from SQL. But LINQ is very different from SQL, 
and if you try to think about LINQ the way you think about SQL, 
you’ll end up with code that doesn’t do what you expect. 


One big difference between the two is that SQL operates on tables, 
which are very different from enumerable objects. One really 
important difference is that SQL tables don’t have an order, but 
enumerable objects do. When you execute a SQL select against a 
table, you can be sure that the table is not going to be updated. SQL has 
all sorts of built-in data security that you can trust. 


If you want to get to the nuts and bolts: SQL queries are set operations, 
which means they don’t examine the rows in the table in any predictable 



TKcjrc a \ 0 i ^ oi ^ 

bc-twcch LIH 6 ^ 

dhd but you (Wt 

■(» delve i h -to them just 

y c f ih ov，d ^ wovkiha 

v^h Hght how/ Just 


appv*oa 匕 h it with dh opCh 

3hd doh’t expert i-fc -to 
wovk -the way 爆 w 。也 


order. A collection, on the other hand, can store anything ~values, structs, 
objects, etc. — and enumerable objects, or sequences, have a specific 
order. (A table’s rows aren’t in any particular order until you make a 
SQL query that orders them; items inside a list, on the other hand, are 
in order.) And LINQ lets you perform any operation that’s supported 
by whatever happens to be in the sequence — it can even call methods 
on the objects in the sequence. And LINQ loops through the sequence, 
which means that it does its operations in a specific order. That may 
not seem all that important, but if you’re used to dealing with SQL, it 
means your LINQ queries will surprise you if you expect them to act 
like SQL. 


you are here ► 
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so that's what that back button is for 


Jimmy could use some help 


Let’s help Jimmy out by building him a Windows Store app 
to help him manage his comic collection — and to show 
him just how useful LINQ^can be when it comes to data. 


Jimmy's Comics 


Available Queries 



L1NQ makes queries easy 

A sample query 

Let's show Jimmy how flexible UNQ is 


Expensive comics 

Comics over $500 

Comics whose value is over 500 bucks. Jimmy can use this to figure out which comics are most 
coveted. 


Windows Store apps use page-based navigation 


Open up the toolbox and find a XAML equivalent of the WinForms 
Tab Control. Can’t find it? That’s not an accident. Tabs are a staple 
of desktop applications, but when you’re not using them they can 
clutter up the screen. Windows store apps use a navigation system 
that’s based on pages, which can reduce that clutter and provide 
a more intuitive interface for your program. 


IVheh you\r app navigates io 如 o 七 h 饮 
the bade butfcoh becomes 


Jimmy's Comics 

Available Queries 

■ UNQ makes queries easy 

A sample query 

Let's show Jimmy how flexible UNQ is 



visible ； Jirwrwy use it bo 

navigate b 把 k "to the previous page. 


© Expensive comics 



Jimmy c\\cks oy\ air\ item list 

^•,cs on mam a 汗 

■to tVic detail fajc n. 



Hippie Madness (misprinted) is worth $13,525.00 


Johnny America vs. the Pinko is worth $3,600.00 


Woman s Work is worth $650.00 


Read more about navigation design for Windows Store apps here: 
http://msdn.microsoft.com/en-us/librarv/windows/apps/hh761500.aspx 
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Use the IPE to explore app page navigation 


Here’s another chance to use the IDE as a learning tool. Go to any Windows Store app that you’ve built and open 
up App.xaml.es. That’s your main application file, and every Windows Store app has one. It’s a subclass of a class 
called Application in the Windows . UI • Xaml namespace, and it’s always in a file named App.xaml. Your app’s 
Application object initializes the app, and manages app lifetime: launching, suspending, and resuming. And it 
does another really useful thing: it creates a Frame object (from Windows . UI • Xaml. Controls), which is what 
your app uses to support navigation in your XAML pages. 

Find the OnLaunched () method in your App class. It’s run every time your app is launched, and it sets up the frame: 


III <summary> 

III Invoked when the application is launched normally by the end user. Other 
III will be used when the application is launched to open a specific file, to 


entry points 
display 



// Place the frame in the current Window 
Window. Current.Content = rootFrame : 


if (rootFrame.Content == null) 


lA/liCh you delete rt w’rth a Bdsi£. Pay 

v/rth the same youVc addmj a Rampage dlass -to vcpladc 
-the or>c you amoved, so ihc NavigatcO mc-thod ^ 

taw d youv hewly added pajc msicad o( -the dc-faul-t o^c. 


// When the navigation stack isn't restored navigate to the first page_» 

// configuring the new page by passing required information as a navigation 
// parameter 

if (!rootFrame.Navigate(typeof (MainPage) j args.Arguments)) ^ - 


throw new Exception ("Failed to create initial page"); 


// Ensure the current window is active 
Window .Current.Activate(); 


This is how the app brings up your 
main page. The Frame. Navigate () 
method creates a new instance of a 
page and then displays its contents. 
The typeof keyword returns the type 
of a class, so that’s how it knows what 
_page type to instantiate._ 


Your apps can use the same Frame . Navigate () method to navigate between pages, too. Every XAML page has a 
property called Frame. If you were to add a page called AnotherPage to your app, here’s how you’d navigate to it. 

Notice the argument query passed to Navigate () . That’s a parameter being passed to the newly created page. 

if (this.Frame != null) 

this.Frame.Navigate(typeof(AnotherPage ) r query); 

|*P you add a fay called the IP£ adds the AnotherPage . 

t\ass -to youv- fv-ojed-t, av\d this todt will navigate *to a mw o ? 」 you are here ► 659 
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Flip to leftover #5 
in the appendix to 
learn more about the 
typeof keyword. 









new app familiar pattern 


Start building Jimmy an app 

You’ll build an app that uses page navigation to execute different 
LINQ queries, starting with the two queries that you’ve seen so far. 



Create a new Windows Store app project. 



Use the Blank App template, delete the MainPage.xaml file, and add a new Basic Page called 
MainPage.xamL Then add another Basic Page called Query Detail, xaml. Don’t forget 
to choose Rebuild Solution from the Build menu before you go on to step #2. 



Add the Comic class. 


You already saw the Comic class from a few pages ago, so go ahead and add 
that class to your project. 

class Comic { 

public string Name { get; set; } 
public int Issue { get; set; } 




Add the ComicQuery class. 

You’ll need this class to represent a query, and when this app is done you’ll have 
one instance of ComicQuery for each LINQquery in the chapter. Have a look 
at the screenshot two pages ago. Each of the queries has an icon, so you’ll need 
a way to represent that in your class. You’ll do that using a Bitmap Image 
object. Bitmaplmage is in the Windows . UI • Xaml. Media . Imaging 
namespace, so you’ll need a using statement at the top of your class. 

using Windows.UI•Xaml.Media.Imaging; 



class ComicQuery { 

public string Title { get; private set; } 
public string Subtitle { get; private set; } 
public string Description { get; private set; 
public Bitmaplmage 工 mage { get; private set; 



V® u put "the usih^ 
statcmch-t inside of the 


dc^lava-tioh m 
youv*-pile i- (- you 七 . 


public ComicQuery(string title, string subtitle, 

string description, Bitmaplmage image) { 

Title = title; 

Subtitle = subtitle; 


Description = description; 
工 mage = image; 
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Add a query manager class so your controls have something to bind to. 


Jimmy’s app will follow the same pattern that you used with the last two apps. The 
ComicQueryManager class will do all of the work of running the queries and 
exposing properties that contain the results. Each XAML page will have a static 
resource that contains an instance of ComicQueryManager, calling its methods 


to run the queries and data binding the results to 

using System. Collections . Obj ectModelo¬ 
using Windows.UI•Xaml.Media.Imaging; 


controls. 

OY\ 七 he md'm fay is bound 
•bo i\\t Availablc^ucvics 


class ComicQueryManager 


pv-opcvty. 



ComicQueryManager 

AvailableQueries 

CurrentQueryResults 

Title 


UpdateAvailableQueriesf) 

UpdateQueryResultsf) 

static BuildCatalogf) 

static GetPricesf) 

private LinqMakesQueriesEasy() 

private ExpensiveComicsf) 

private CreatelmageFromAssetsf) 
— 


public ObservableCollection<ComicQuery> AvailableQueries { get; private set; } 


public ObservableCollection<obj ect> CurrentQueryResults { get; private set; } 

t 

public string Title { qet; set; i ， -r» 广 »^ 1 n " . , 

—' The Cuv\rcht^uc\ryRcsul-ts a^d Title pv-opcv-tics avc used -to 

public ComicQueryManager() { display the «\uc\ry \rcsults oy \ the ^ucv-yDctail page. 

UpdateAvailableQueries (); 

CurrentQueryResults = new ObservableCollection<object>(); 


private void UpdateAvailableQueries() { 

AvailableQueries = new ObservableCollection<ComicQuery> { 


TKis tollc^tioh 
’m’rt’ializjcv 



objects bo display 


new ComicQuery ("LINQ makes queries easy，'， n A sample query ", 

"Let's show Jimmy how flexible LINQ is n , 

CreatelmageFromAssets("purple_250x250.j pg M )), 

new ComicQuery("Expensive comics ”， "Comics over $500" A 
"Comics whose value is over 500 bucks." 

+ " Jimmy can use this to figure out which comics are most coveted. n , 
CreatelmageFromAssets( n captain_amazing_250x250•jpg n )), 


private static Bitmaplmage CreatelmageFromAssets(string imageFilename) 


return new Bitmaplmage(new Uri("ms-appx : ///Assets/ 


public void UpdateQueryResuits(ComicQuery query) 
Title = query.Title; 


+ imageFilename)); 

_ 


The ^uc\rypctail 

page uses 七 his 
rwc-thod -fco \TUID 3 
Lll^ <\uc\ry. 


switch 


Have a close look at the 
CreatelmageFromAssets() 
method. Can you figure out 
what’s going on here? 


(query.Title) { 

case "LINQ makes queries easy ，，： LinqMakesQueriesEasy () ; break; 
case "Expensive comics" : ExpensiveComics(); break; 


Before you flip the page to see the rest of the class, can you figure out 
what the LinqMakesQueriesEasy () and ExpensiveComics () 
methods will look like? The app will call those methods to run LINQ queries. 


參 


+ 


you are here ► 
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a rose by any other name 




public static 工 Enumerable<Comic> BuildCatalog() 
return new List<Comic> { 


new 

Comic 

{ 

Name 

new 

Comic 

{ 

Name 

new 

Comic 

{ 

Name 

new 

Comic 

{ 

Name 

new 

Comic 

{ 

Name 

new 

Comic 

{ 

Name 

new 

Comic 

{ 

Name 

new 

Comic 

{ 

Name 


’Johnny America vs. the Pinko", Issue =6 }, 

’Rock and Roll (limited edition)", Issue = 19 }, 

’Woman's Work ", Issue =36 }, 

’Hippie Madness (misprinted )", Issue =57 }, 

'Revenge of the New Wave Freak (damaged )", Issue =68 }, 
’Black Monday ", Issue = 7 4 }, 

’Tribal Tattoo Madness ", Issue = 83 }, 

'The Death of an Object ，'， Issue = 97 }, 


private static Dictionary<int, decimal 〉 GetPrices() 
return new Dictionary<int, decimal 〉 { 


{ 

6, 

3600M }, 

{19, 

500M 


{36, 

650M }, 

{57, 

13525M }, 

{ 

68, 

250M }, 

{74, 

75M 


{ 83, 

25.75M }, 

{97, 

35.25M }, 



These a\rt the same 
BuildCa-talogO a h d 
$ 七 Ph 匕 esO methods 
•(Vom a -Pew pages ago. 


private void LinqMakesQueriesEasy() 
int[] values = new int[] { 0, 12 

var result = from v in values 

where v < 37 
orderby v 
select v; 

CurrentQueryResults.Clear(); 
foreach (int i in result) 

CurrentQueryResults.Add( 

new { 


44, 36, 92, 54, 13, 8 


M s 七 ill doh khow how 七 he 

Cv*C3*tc|r»30Cp\rorh/\ssctsO mctliod WOV*ks ; 
but I bet wc II -Pihd out oh -the hext 


Title 

Image 


i. ToStringO , 

CreateImageFromAssets("purple 250x250.jpg ”）， 


private void ExpensiveComics() 
工 Enumerable<Comic> comics 


BuildCatalog() 


Dictionary<int, decimal〉values = GetPrices () 

var mostExpensive = from comic in comics 
where values[comic • 工 ssue] > 500 
orderby values[comic • 工 ssue] descending 
select comic; 

CurrentQueryResults.Clear(); 

foreach (Comic comic in mostExpensive) 
CurrentQueryResults.Add( 

new { 


Each of these methods executes one 
of the LINQ queries from earlier in the 
chapter. Instead of writing each result 
to the console, it adds each result to the 
CurrentQueryResults property, an 
ObservableCollection<object> 
collection. But take a close look at the 
new { } statement. Somehow you’re 
using the new keyword with an object 
initializer. Usually there’s a type after the 
new keyword, but these statements leave 
it out so they can create instances of 

_anonymous types._ 


Title = String.Format( M {0} is worth {l:c} n , 

comic.Name, values[comic.Issue]), 

Image = CreatelmageFromAssets("captain amazing 250x250.jpg"), 
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Use the wgw keyword to create awowymous types 

You’ve been using the new keyword since Chapter 3 to create instances of objects. Every time you 
use it, you include a type (so the statement new Guy () creates an instance of the type Guy). But 
you can also use the new keyword without a type to create an anonymous type. That’s a perfectly 
valid type that has read-only properties, but doesn’t have a name. You can add properties to your 
anonymous type by using an object initializer. 

Here’s the statement from the ExpensiveComics query on the facing page that creates an 
instance of an anonymous type to add to the collection in the CurrentQueryResuits property: 

new { 

Title = String. Format ( n {0} is worth {1 •• c} n , 
comic.Name A values[comic.Issue]), 

Image = CreatelmageFromAssets("captain 一 amazing 一 250x250•jpg n ), 

} ~ ~ 

When you run the program, you can see the objects that it creates just like any other 
objects. Here’s what an instance of that anonymous type looks like in the Watch window: 

: ^ Image {Win dows.UI.Xaml.Media.lrn aging .Bitmap Image} 

A Title ▼ "Hippie Madness (misprinted) is worth S13 r 525.00" 


This works just like any other object initializer. You can call methods 
like CreatelmageFromAssets () and String. Format () in 
the object initializer to populate the object’s properties. (Of course, 
you can also set them to values if you need to, too.) 

The one thing you can’t do is refer to the name of the type, because 
the type doesn’t have a name! That’s where the var keyword comes 
in very handy, because you can use it to hold a reference to an 
anonymous type — like this: 

var myAnonymousObj ect = new { 

Name = "Bob ", 

Flip to leftover #9 in the appendix to 
learn more about anonymous types. 

Console.WriteLine(myAnonymousObject.Name); 

That code creates an instance of an anonymous type, saves a reference to that new object in the 
myAnonymousOb j ect variable, and uses it to write the Name property to the output. 

Flip the pa^e to finish the af p - ► 
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Cash = 186.3M, 
Age = 37, 


a_non_ 广 mous，adjectiv 

not identified by name. Secret 
Agent Dash Martin uses his alias U 
become anonymous to keep the 
KGB agents from recognizing him. 














finish jimmy’s app 



Add image files to the Assets folder in your project. 




Find the image files purple_250x250.jpg and captain_amazin§^250x250.jpg for this project (you can download 
them from http://wwmhea4firstlabs.com/hfcslmrp) and save them in a folder. Then go to the Solution Explorer, 
right-click on the £1 Assets folder, choose Add—Existing Item from the menu, and add the files. Now have a 
close look at the CreateImageFromAssets method: 


private static Bitmaplmage CreatelmageFromAssets(string imageFilename) { 

return new Bitmaplmage(new Uri("ms-appx :// /Assets/" + imageFilename)); 


Every file in your project has a unique name in the ms-appx namespace. The file purple_250x250.jpg in the 
Assets folder has the unique identifier ms-appx:///Assets/purple_250x250.jpg. You can use that identifier to load the 
file into a Bitmaplmage object, and in a minute you’ll see how that object can be bound to an <Image> 
control in your XAML. 


Finish the XAML and code-behind for the main page. 

Open MainPage.xaml. Here are the resources for the page: 

<Page.Resources 〉 

〈 local:ComicQueryManager x : Name= M comicQueryManager" / > 
<x : String x : Key= M AppName">Jimmy's Comics</x : String> 
</Page.Resources 〉 


The ListView control 
automatically adds vertical 
scrollbars if the list items 
scroll off the bottom. Try 
adding Height:” * n to the 
second RowDefinition in the 
Grid’s row definitions. The 
scrollbars disappear! That’s 
because the row expands to 
fit all of the ListView’s items. 


ScttmJ the 
ScIcdtio^Modc 
pv-ofcv-ty *to 
Hor\t disables 
•the list 


Use a StackPanel to lay out the content: 

<Grid Grid.Row= M l" Margin= n 120,0 n 

DataContext="{StaticResource ResourceKey=comicQueryManager} ▼，> 

<Grid.RowDefinitions> 

<RowDefinition Height= M Auto" / > 

<RowDefinition/> 

</Grid.RowDefinitions> 

<TextBlock Style= M {StaticResource SubheaderTextStyle}" 

Text="Choose a query to run" Margin= n 10,0,0,20"/> 

<ListView Grid.Row="l n Margin= n 0,-10,0,0 n 工 temsSource= n {Binding AvailableQueries}" 

工 temTemplate= n {StaticResource Standardl30ltemTemplate} n 
- ^ SelectionMode="None M IsItemClickEnabled= n True n 工 temClick= n ListView 工 temClick n /> 


The IsItcruClidkE^ablcd 

pv-opc\rty causes -the 
Lis-tl/icw "to -five "the 
I 七 emCIi 匕 k when an 

is didked. 


</Grid> 


And add this event handler to the code-behind. The SelectionChanged event handler for a ListView can access 
the items that were selected using the e . AddedI terns. The ListView is bound to an ObservableCollection 
of ComicQuery objects, so e . AddedI terns [ 0 ] will always contain the ComicQuery that the user clicked on. 
You’ll pass that as a parameter to the new page using Frame . Navigate (). 
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private void ListView—ItemClick(object sender, 工 temClickEventArgs e) { 
ComicQuery query = e•Clickedltem as ComicQuery; 
if (query != null) 

this.Frame.Navigate(typeof(QueryDetail ), query); 
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You add b> method *to 

f>ass av\ object as a pa\ramc*tcv -to youVc -to. 
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Finish the XAML and code-behind for the query detail page. 

Open QueryDetailxaml. Here are the resources for the page: 

<Page.Resources 〉 

〈 local:ComicQueryManager x : Name="comicQueryManager" / > 
<x : String x : Key= M AppName M >Query Detail</x : String> 
</Page.Resources 〉 


Use another Grid to lay out the content: 

<Grid Grid.Row= M l" Margin= n 120,0，' DataContext= M {StaticResource ResourceKey=comicQueryManager}"> 
<Grid.RowDefinitions> 

<RowDefinition Height= M Auto M /> <RowDefinition/> < - pu 七 multiple <Rov/Dc-fmiiio^> 

</Grid. RowDef initions> 丄 ~ i, 

oy \ the sdme Ime- 

<TextBlock Style= M {StaticResource SubheaderTextStyle}" J 

Text="Query results" Margin="10,0,0,20"/> 

<ListView Grid.Row="l" Margin= n 0,-10,0,0 n 工 temsSource=，'{Binding CurrentQueryResults}" 

工 temTemplate= n {StaticResource Standardl30ltemTemplate} n SelectionMode="None n /> 

</Grid> 

When the main page calls Frame . Navigate () to navigate to the query detail page, it passes a 
ComicQuery as a parameter. You can access that parameter by overriding the OnNavigatedTo () 
method in the code-behind and using e . Parameter to access the navigation parameter: 

protected override void OnNavigatedTo(NavigationEventArgs e) { 

ComicQuery comicQuery = e.Parameter as ComicQuery; 
if (comicQuery != null) { 

ComicQueryManager.UpdateQueryResults(comicQuery); 
pageTitle.Text = ComicQueryManager.Title; 




base.OnNavigatedTo(e); 




The pvopcv-tics ov\ ihc Comi^^uc\ry objedi Bv\d -the ar>oK>ymous 
} 七 ypes tYtaitd by youv Ll^ *\ucvics wtdh 七 he ii 

七 he Da-taTcmpla-tc, so 七 hey show up m ihc Lisi\/icy/- 
Run your program! And then use the IDE to explore it and understand how it works. 

So how does your program display the images in each ListView? It’s not a mystery. The ListView controls 
use the ItemTemplate Standardl30ItemTemplate. Use the IDE to search for that template in the 
project. You’ll find it in StandardStyles.xaml. It’s a datatemplate, just like the one you used in Chapter 10: 

< Border Background = 11 {Static Re source ListViewItemPlaceholderBackgroundThemeBrush } 1f WidthsUll® 111 Height = l, ll&"'> 

< Image 5ourc-e= "{Binding Image} 1 ' 5tretch= 1B IJn ifo ™T oF iII" AutomationProperties.Narie = ''{Binding Title}'V> 
</Border> 

<StackPaneI Grid ■ Column: 'l 1 ' VArticalAlignrient= ,r Top " Margin: 'm 

<Text Block Text = " {Binding Title} 1 ' Style = " {5t at i c Re so u r c e Tit leText Style } 1F T-extWrapping= l, NbWrap"/> 

<Text Block Text = "' {Binding Subtitle} 1 ' Style = lp {St at ic Re source CaptionTextStyle}" TextWrapping= l, Nbyrap 1, /> 

<Text Block Text = "'{Bindii/g Description} 1 ' Style = 11 {St at i c Re so u r ce BodyTextStyle } IP MaxHe ight =" 6 &" / > 

</StackPanel> 


平 





Expensive comics 

Comics over $500 y 

Comics wh^$e^lue is over 500 bucks. Jimmy can use this to figure out which comics are most 
coveted.^— 




you are here ► 
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that’s why jimmy loves LINQ 

LINQ is versatile 

You can do a lot more than just pull a few items out of a 
collection. You can modify the items before you return them. 

And once you’ve generated a set of result sequences, LINQ gives 
you a bunch of methods that work with them. Top to bottom, 

LINQ gives you the tools you need to manage your data. 

o Modify every item returned from the query. 

This code will add a string onto the end of each string in an array. It doesn’t 
change the array itself — it creates a new sequence of modified strings. 


All collections are enumerable — they 
implement IEnumerable<T> — but not 
everything that’s enumerable is technically 
a collection unless it implements the 
ICollection<T> interface, which 
means implementing Add () , Clear (), 
Contains (), CopyTo (), and Remove ()... 
and, of course, ICollection<T> 
extends IEnumerable<T>. LINQ deals 
with sequences of values or objects, not 
collections, and all you need for a sequence is 
an object that implements IEnumerable<T>. 



string[] sandwiches = { ” ham and cheese ”， "salami with mayo ", 

"turkey and Swiss' 1 , "chicken cutlet" }; 

var sandwichesOnRye = 


from sandwich in sandwiches 
select sandwich + 


on 


㉟ 。 


foreach (var sandwich in sandwichesOnRye) 
Console.WriteLine(sandwich); 

"0 

Uohu tKat all Wd Kavc 

u ov\ added *to cy\A- 


Perform calculations on collections. 


Output: 


ham and cheese on rye 
salami with mayo on rye 
turkey and swiss on rye 
chicken cutlet on rye 



This is 

^dc "to the items 
the \rcsults o-f 
you\r 饮 y … but 
"to the itcr^s 
•… the o\ri^ihdl 
^ollc^tioh ov- 
dd'tdbase. 


Remember, we said LINQ provides extension methods for your collections 
(and anything else that implements 工 Enumerable<T>). And some of 
those are pretty handy on their own, without actually requiring a query: 
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Random random = new Random(); 

List<int> listOfNumbers = new List<int> (); 
int length = random•Next(50, 150); 
for (int i = 0; i < length; i++) 

listOfNumbers.Add(random.Next(100)); 


Console.WriteLine("There are {0} numbers ", 

listOfNumbers.Count()); <~ 
Console.WriteLine("The smallest is {0} n , 

listOfNumbers.Min()); ^ - 

Console . WriteLine ("The biggest is {0} n , 

li stOf Numbers .Max () ) 

Console.WriteLine("The sum is {0} n , 

listOfNumbers.Sum()); 

Console . WriteLine ("The average is { 0 : F2 }’▼, 


listOfNumbers .Average()); 
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Bv\ |E>r>urwcv-ablc<T>. 



Store all or part of your results in a new sequence. 

Sometimes you’ll want to keep your results from a LINQ query 
around. You can use the ToList () command to do just that: 

TVis tiw'C, >wcVc 

var under50sorted = 

from number in listOfNumbers 
where number < 50 
orderby number descending 
select number; 



sov*bi^5 ^ 七 

y\umkcv-s m 
dcstc^d'm^ ov-dev-, 

loy/es 七 . 


List<int> newList = under50sorted.ToList() 

You can even take just a subset of the results, using 
the Take () method: 

var firstFive = under50sorted.Take(5); 



LINQ queries 
aren’t run until 
you access 
their results! 


Watch it! 


It’s called “deferred 
evaluation” 一 the 
LINQ query doesn’t actually do 
any looping until a statement is 
executed that uses the results 
of the query. That’s why ToList() 
is important: it tells LINQ to 
evaluate the query immediately. 



l U i° — 士川 / ^ w ‘ a Lisi<T> 
n Z CS A als ° LayO Ad ToV^ho^yO 

methods, whi^h do just what you ； d 


dlrouhd- 


List<int> shortList = firstFive. ToList ();< 
foreach (int n in shortList) 

Console.WriteLine(n); 


TakcO pulls out 如 sullied J 心 w 

(Wsi set results a 

L|N($ <\ucry. Vou t^ese mto ar^othev 

var, a^d *t^at m*to a list 

O Check out Microsoft’s official 101 LINQ Samples page. 

There’s way more that LINQ can do. Luckily, Microsoft gives you a great little reference to help you along. 

http : //code.msdn.microsoft.com/101-LINQ-Samples-3fb9811b 



Dumb Quest? 


9ns 


That’s a lot of new keywords— from, 
where, or derby, select, "it’s like a 
whole different language. Why does it look 
so different from the rest of C#? 


var under10 = 

from number in numberArray 
where number < 10 
select number; 


And that’s why LINQ looks a little odd: 
because C# has to cram a whole lot of 
behavior into a very small space. 


A! Because it serves a different purpose. 
Most of the C# syntax was built to do one 
small operation or calculation at a time. You 
can start a loop, or seta variable, or do a 
mathematical operation, or call a method... 
those are all single operations. 

LINQ queries look different because a single 
LINQ query usually does a whole bunch of 
things at once. Let’s take a closer look at a 
straightforward query: 


It looks really simple—not a lot of stuff there, 
right? But this is actually a pretty complex 
piece of code. Think about what’s got to 
happen for the program to actually select all 
the numbers from numberArray that 
are less than 10. First, you need to loop 
through the entire array. Then, each number 
is compared to 10. Then those results need 
to be gathered together so your code can 
use them. 


LIVQ lets you write 
queries tkat do very 


complex tkings using 


very little code. 
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expand jimmy’s app 

Add the wgw queries to Jimmy's app 


This is example o-P sepavaiio^ o( to^dev-hs. ^>u 
sdd 'uemies by modi*fy'm^ Comid^ucv-yAla^ajcv- 
W’rthou 七 aK>y XA/WL ov dodc-bchmd bemuse 

Y ou c^tapsulaicd all o( -the <\uc\ry code m 七 ha 七 dass. 


Jimmy’s curious about how LINQcan help manage his data. Add the three queries from the 
previous pages to the app to show him what LINQcan do. All you need to do is update the 
ComicQueryManager class (and add another image to the Assets folder). Start by adding 



three ComicQuery objects to the object initializer for the AvailableQueries property: 


private void UpdateAvailableQueries() { 

AvailableQueries = new ObservableCollection<ComicQuery> { 

new ComicQuery( n LINQ makes queries easy ", "A sample query ", 
"Let' s show Jimmy how flexible LINQ is ，，， 

CreateImageFromAssets("purple_250x250.jpg ")), 




this 

餐 


new ComicQuery("Expensive comics ", "Comics over $500 n , 

"Comics whose value is over 500 bucks.，' 

+ ，， Jimmy can use this to figure out which comics are most coveted .，，， 
CreatelmageFromAssets("captain_amazing_250x250.j pg ")), 


new 


Add these 

*th\rcc queries 
so *thcy show 
up oy \ "the 


new 


new 


ComicQuery("LINQ is versatile l n , "Modify every item returned from the query", 
"This code will add a string onto the end of each string in an array.，▼, 
CreatelmageFromAssets ( n bluegray—250x250 • jpg")), 

ComicQuery("LINQ is versatile 2 n , "Perform calculations on collections ”， 

"LINQ provides extension methods for your collections (and anything else" 

+ '▼ that implements IEnumerable<T>) . n , 

CreatelmageFromAssets (’ 'purple 一 250x250 • jpg")), 

ComicQuery(▼▼ LINQ is versatile 3 n , 

"Store all or part of your results in a new sequence", 

’ ▼Sometimes you'll want to keep your results from a LINQ query around. 
CreatelmageFromAssets ( M bluegray_250x250 . jpg")), 


Next, you’ll need to update the switch statement to run the queries when they’re selected in the ListView: 

public void UpdateQueryResuits(ComicQuery query) { 

Title = query.Title; 


switch (query.Title) { 

case ，’ LINQ makes queries easy" : LinqMakesQueriesEasy (); 
case "Expensive comics" : ExpensiveComics(); break; 

case "LINQ is versatile 1' ▼: LinqlsVersatilel(); break; 

case "LINQ is versatile 2" : LinqIsVersatile2(); break; 

case "LINQ is versatile 3' ▼: LinqIsVersatile3(); break; 


break; 



Add "these dascs -to 七 he 

sy/rt^h s-ta-terwe^t Thcyll yt 
c^cdu-tcd by the <^uc\ry detail 
page when ii’s ^vigated -fco. 
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You’ll need to add these three methods. Compare them with the LINQ queries on the previous two pages: 

private void LinqlsVersatilel() { 

string [ ] sandwiches = { "ham and cheese ", "salami with mayo ，'， 

"turkey and swiss ", "chicken cutlet" }; 
var sandwichesOnRye = 

from sandwich in sandwiches 
select sandwich + " on rye"; 


CurrentQueryResults.Clear(); 

foreach (var sandwich in sandwichesOnRye) 

CurrentQueryResults.Add(CreateAnonymousListViewItem(sandwich, n bluegray_250x250.jpg")); 


private void LinqIsVersatile2() { 

Random random = new Random(); 

List<int> 1istOfNumbers = new List<int>(); 
int length = random.Next(50, 150); 
for (int i = 0; i < length; i++) 

listOfNumbers.Add(random.Next(100)); 


You'll need to download the 
bluegray_250x250.jpg file from 
the Head First Labs website 
and add it to your Assets folder. 


CurrentQueryResults.Clear (); 

CurrentQueryResults.Add(CreateAnonymousListViewItem( 

String.Format("There are {0} numbers ", listOfNumbers.Count ()))); 


CurrentQueryResults.Add( 

CreateAnonymousListViewItem(String•Format( n The smallest is {0} n , listOfNumbers.Min()))); 
CurrentQueryResults.Add( 

CreateAnonymousListViewItem(String•Format('’The biggest is {0} n , listOfNumbers.Max()))); 
CurrentQueryResults.Add( 

CreateAnonymousListViewItem(String•Format(’’The sum is {0} n , listOfNumbers.Sum()))); 
CurrentQueryResults.Add(CreateAnonymousListViewItem( 


String.Format("The average is {0:F2} n , listOfNumbers.Average()))); 


private void LinqIsVersatile3() { 

List<int> listOfNumbers = new List<int> (); 

for (int i = 1; i <= 10000; i++) 
listOfNumbers.Add(i); 

var under50sorted = 

from number in listOfNumbers 
where number < 50 
orderby number descending 
select number; 

var firstFive = under50sorted.Take(6); 

List<int> shortList = firstFive.ToList(); 



|p-D< 


th 


is 


You need to add one more method to 
make this code work. Each of these three 


LinqisVersatile methods calls another method 
called CreateAnonymousListViewItem () ■ 

Its first parameter is the title, and it should be used 
as the Title property in a new anonymous object. 
The second is an optional parameter. It’s the name 
of the image file to load into the image property 
of the anonymous object, and it should default to 
purple_250x250.jpg if it's not included. Can you come up 
with this method? The answer is on the next page. 


foreach (int n in shortList) 


CurrentQueryResults.Add(CreateAnonymousListViewItem(n•ToString(), n bluegray_250x250.jpg")); 
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a little review 


^^BUUET POINTS 


from is how you specify the 工 Enumerable<T> 
that you’re querying. It’s always followed by the 
name of a variable, followed by in and the name 
of the input (from value in values). 

where generally follows the from clause. That’s 
where you use normal G# conditions to tell LINQ 
which items to pull (where value < 10). 

orderby lets you order the results. It’s followed 
by the criteria that you’re using to sort them, and 
optionally descending to tell it to reverse the 
sort (orderby value descending). 

This is jus 七 like {0：%} you used m ChafW °l v/heir; you 

built he% dumfev-. also [O'd] ar\d {0 ： P} - 

short dates, a^d {0?} or {0:PrJ *to fvmt a 

pcv*dc^*t (wrth decimal pladcs). 


select is how you specify what goes into the 
results (select value). 

Take lets you pull the first items out of the results 
of a LINQquery (results . Take (10)). 

LINQgives you other methods for each sequence: 
Min () , Max () , Sum () ， and Average () . 

You can select anything — you’re not limited to 
selecting the name that you created in the from 
clause. Here’s an example: if your LINQquery 
pulls a set of prices out of an array of int values 
and names them value in the from clause, 
you can return a sequence of price strings like 
> this: select String. Format (’ ▼ { 0 : c } ’▼ , 
value). 





rciSg 
SPLutiOH 


private object CreateAnonymousListViewItem(string title, 

string imageFilename = n purple_250x250.jpg") { 

return new { ,, ,. . . 

rteve s tnc optional 

Title 二 title. 

Image = CreatelmageFromAssets (imageFilename), pavamcicr. |-P i^s Ic-Pi 

} ； out, 七 he pu\rplc bo 乂 is used. 




D 


tWeiqr 

)umb 


e no o 

Questions 


How does the from clause work? 


It’s a lot like the first line of a 
foreach loop. One thing that makes 
thinking about LINQ queries a little tricky is 
that you’re not just doing one operation. 


A LINQ query does the same thing over and 
over again for each item in a collection. The 
from clause does two things: it tells LINQ 
which collection to use for the query, and it 
assigns a name to use for each member of 
the collection that's being queried. 


The way the from clause creates a new 
name for each item in the collection is really 
similar to how a foreach loop does it. 
Here’s the first line of a foreach loop: 

foreach (int i in values) 


That foreach loop temporarily creates 
a variable called i, which it assigns 
sequentially to each item in the values 
collection. Now look at a from clause in a 
LINQ query on the same collection: 

from i in values 

That clause does pretty much the same thing. 
It creates a temporary variable called i and 
assigns it sequentially to each item in the 
values collection. The foreach loop 
runs the same block of code for each item in 
the collection, while the LINQ query applies 
the same criteria in the where clause 
to each item in the collection to determine 
whether or not to include it in the results. But 
one thing to keep in mind here is that LINQ 
queries are just extension methods. They 
call methods that do all the real work. You 
could call those same methods without LINQ. 


How does LINQ decide what goes 
into the results? 

A! That's what the select clause is 
for. Every LINQ query returns a sequence, 
and every item in that sequence is of 
the same type. It tells LINQ exactly what 
that sequence should contain. When 
you’re querying an array or list of a 
single type—like an array of ints ora 
List<string>— it's obvious what 
goes into the select clause. But what 
if you’re selecting from a list of Comic 
objects? You could do what Jimmy did 
and select the whole class. But you could 
also change the last line of the query to 
select comic. Name to tell it to 
return a sequence of strings. Or you could 
do select comic • Issue and have 
it return a sequence of ints. 
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are you a LINQ groupie? 


LINQ Magnets Solution 

Rearrange the magnets so they produce 
the output at the bottom of the page. 


LlN 公 s*tarb 七 h some sort 

o-f sc^uc^C-C) tollct*t*on, ov 
av-v-aY* -m *t^ ,s ^^ sc, ^ 

» 广 m-tc^cv-s. 







var skunks 




MitY this siaie^i 
skuhks ^oh-fcaihs -fouv 
humbcirs ： ^ \l } \ 0) ah(J g 


(pigeon != 36 && pigeon 

^^goon^descending | 


< 50) 



TKis L|N^5 s*ta*tcmcir>*t pulls all 

i\\t ^umbev-s *tKa*t a^rc below 
^0 ar>d r>o*t c«\ual *to ^ ou*t 
Jc *tKc avvay, adds ^ -to catii 

o( -tKcm, SOV*b *tKcm -fv-om 

bi^cs*t *to smallest fu*ts 
•m a Y\t^i objcd*t, 3r^d fo'm*U 

-tiic skunks vc-fcvcir>dc a*t i*t- 


A*fW *tWis 
S*ta*tcmCir\*t) bcav-S 个 

toK\*ta'ms {\\rtt J 、 

numbers ： B) ■ ~ / 
ay\d 10. 


var bears 



土:: 二心 

hCW caWtd bca^s. 


a 



var weasels 


^b^s ： ^ j Z) ^ 



Tills s-tatcrwCh-t jus-t subtv-a^ts / *(Vo» 
没乩 humbc\T ih bca\rs Bv\d puts them 
all nvfco wedsels. 


Console. WriteLine("Get your kicks on route {0}", 

weasels. Sum () f )71 ^easels add 外 从 . 


午 5 + IZ + 巧二从 




TV^c ^uwbevs m 


Output: 

Get your kicks on route 66 
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LINQ caw combine your 
results into groups 

You can use LINQto build your results into groups, 
which can be really useful when you need to slice 
and dice your collections. Let’s take a closer look at a 
query that breaks a collection into groups. 

var beeGroups = 



You can see this LINQ query in action 
(and learn more about how WinForms 
applications work) by building some 
nifty animation in a beehive simulator. 
Download the free GDI+ chapter from 
http://headfirst_abs.com/hfcsharp. 

The query starts out just like the other queries you’ve 
seen — by pulling individual bee objects out of the 
world. Bees collection, a List<Bee> object. 


from bee in world.Bees 


❺ 


roup >ee by bee.Currentstate 


into beeGroup 



orderby beeGroup.Key 


select beeGroup 




The next line in the query has a new keyword: 
group. This tells the query to return groups 
of bees. What that means is that rather than 
returning one single sequence, the query will 
return a sequence of sequences, group 
bee by bee • Currents tate tells 
LINQ to return one group for each unique 
CurrentState property that it finds in the 
bees that it selects. Finally, we need to give 
LINQ a name for the group. That’s what the 
next line is for: into beeGroup says that the 
name “beeGroup” refers to the new groups. 


o 


Now we just have to use the select 
keyword to indicate what’s being returned 
by the query. Since we’re returning 
groups, we select the group name: 

select beeGroup; 


currentState = Maki 



Now that we’ve got groups, we can manipulate them. 
Since we’re returning a sequence of groups, we can 
use the or derby keyword to put the groups in the 
order of the CurrentState enum values (Idle, 
FlyingToFlower, etc.), orderby beeGroup. 
Key tells the query to put the sequence of groups 
in order, sorting them by the group key. Since we 
grouped the bees by their CurrentState, that’s 
what is being used as a key. 

七 he bees weve youfed by •theiv* s*ta*tc> 
we ca\\ that siait the w kcy w A jv-ouf s key 
is 七 he dv-i*tcv-ia i*t >w3s youfed by. 


=FlyingToRo^r 



Co//ec(、 0<V 




currentState = GatheringNectar 



七 4 七 this \rctu\rhs c roup s o-p 

bees, hot ihdividudl bees. 
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the key to success 


Combine Jimmy's values iwto groups 


Jimmy buys a lot of cheap comic books, some midrange comic books, and a few expensive ones, and he wants to know 
what his options are before he decides what comics to buy. He’s taken those prices he got from recent sales on Greg’s List 
and put them into a Dictionary<int, decimal 〉 using his GetPrices () method. Let’s now use LINQto group 
them into three groups: one for cheap comics that cost under SI00, one for midrange comics that cost between SI00 and 
S 1,000, and one for expensive comics that cost over #1,000. We’ll create a PriceRange enum that we’ll use as the key 
for the groups, and a method called EvaluatePrice () that’ll evaluate a price and return a PriceRange. 




Every group needs a key—well use an enum for that. 

The group’s key is the thing that all of its members have in common. The key can be anything: a 
string, a number, even an object reference. We’ll be looking at the prices that Jimmy got from Greg’s 
List. Each group that the query returns will be a sequence of issue numbers, and the group’s key 
will be a PriceRange enum. The EvaluatePrice () method takes a price as a parameter and 
returns a PriceRange: 

enum PriceRange { Cheap, Midrange, Expensive } 

static PriceRange EvaluatePrice(decimal price) { 
if (price < 100M) return PriceRange.Cheap; 
else if (price < 1000M) return PriceRange.Midrange; 
else return PriceRange.Expensive; 


Now we can group the comics by their price categories. 

The LINQquery returns a sequence of sequences. Each of the sequences inside the results has 
a Key property, which matches the PriceRange that was returned by EvaluatePrice () . Look 
closely at the group by clause — we’re pulling pairs out of the dictionary, and using the name pair 
for each of them: pair . Key is the issue number, and pair . Value is the price from Greg’s List. 
Adding group pair . Key tells LINQto create groups of issue numbers, and then bundles all of those 
groups up based on the price category that’s returned by EvaluatePrice () : 


Try adding the code on 
this page to a new Console 
app — see if you can get it to 
work! You’ll add the query to 
Jimmy’s Windows Store app 
at the end of the chapter. 


Dictionary<int, decimal〉values = GetPrices (); 

var priceGroups = 

from pair in values 
group pair.Key by EvaluatePrice(pair.Value) 
into priceGroup 

orderby priceGroup.Key descending 
select priceGroup; 



T\\t -fi^uv-cs ou*t v/iViA youp a 

favtitulav Con\\t belor^s *to by stv\A\y\^ 
i-ts pv-idc bo EvaluatcPvidcO. T\\ai 

uses as youp s key. 


foreach (var group in priceGroups) { 

Console.Write( n I found {0} {1} comics : issues ", group•Count (), group.Key); 
foreach (var issueNumber in group) 

Console.Write(issueNumber.ToString() + ""); 


Console.WriteLine(); 

} 

Bach Jc tKc youfs is d sc<\^cUc, SO y/c - 
added 3r\ irmev* loop *to full 

o-f issue ou*t of youp. 
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Output: 





工 found 

2 

Expensive comics : issues 

6 

57 

工 found 

3 

Midrange comics : issues 

19 

36 68 

工 found 

3 

Cheap comics : issues 74 

83 

97 
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Paa] Puzz]c 

Your job is to take snippets from the 
pool and place them into the blank 
lines in the program. You can use 
the same snippet more than once, 
and you won’t need to use all the 
snippets. Your goal is to make the 
code produce this output: 


Horses enjoy eating carrots, but they love eating apples. 


class Line { 

public string[] Words; 

public int Value; 

public Line (string[] Words 



int Value) { 


this.Words = Words; this.Value = Value; 

} } Hi hi ： Llh/6^ sovts siv'mjs m 

alphabetical o\rdcv. 

Line[] lines = { 

new Line( new string[] { 

▼▼but” ， n enjoy n , 
new Line( new string[ ] { 

"Cows M , "bridge. M 
new Line( new string[ ] { 

"Engine ", "and" }, 


"eating ", 

'Horses M } 

M zebras ? M 
"bolted" 

"fork ", "dogs ! M , 
3 ), 


carrots 

1 ), 

"hay ", 

, 2) r 


new Line ( new string[] { "love ", "they ", 

"apples . M , "eating" ), 2 ), 
new Line ( new string[] { "whistled . M , "Bump 


K 1 ) }; 


var 


from 


m 


line by line 


into wordGroups 

orderby _ 

select 


words 


( 2 ) 


foreach (var group in twoGroups) 


int 


0 ; 


f oreach (■ 

i ++； 
if (i : 


inner in 


Key) 


var poem 


word in 


word descending 


word 


foreach (var word in _ 

Console.Write(word) 


Note: Each snippet 
from the pool can be 
used more than once! 
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two collections walk into a var 



var words — 
from line 


in lines 
qroup line by line. Value 
into wordGroups 
orderby wordGrou ps. Key 
select wordGroups; 

var twoGroups = words .Take (2) 


foreach (var group in twoGroups) 


int i = 0; 
foreach (var inner in qroup) { 

if (i == group. Key) { 
var poem = 




W Avs 七七 …。 ^VOUfS av-c 
y^s Vrth Values I and 


*bV\c 


TK'is loop docs a L 瞻 n 
ov\ -tv^c Viv-s*t okjc£.*t rn 
“st yro^ a^d second Lme 

okjet-t m -t^c second ^ou\>. 


from word 


m 


inner. Words 


orderby word descending 
select word + 

foreach (var word in poem) 
Console.Write(word); 


少 D_d you -Pijuv-c out 七 ha 七 -the 

iv/o phvascs w ttov-scs enjoy catmj 
V tav-vots, but” and w *thcy love 
catmj apples” avc *m destehdmg 
alphabetical ov-dev? 


Output : 


Horses enjoy eating carrots, but they love eating apples. 


class Line { 

public string[] Words; 
public int Value; 

public Line(string[] Words , int Value) { 

this.Words = Words; this.Value = Value 

} 


Line[] lines = { 


new 

Line ( 

new 

string[] { 

"eating ", 

"carrots,", "but' 

’’enjoy’ 

f 

r 

"Horses" 

} r Dr 

new 

Line ( 

new 

string[] { 

"zebras ?" 

, "hay" 

、 ，， Cows ，，， ， 

'bridge.", 

u 

bolted" } 

,2), 

new 

Line ( 

new 

string[] { 

"fork"," 

dogs !", 

"Engine ", 

"and" }, 

3 

) r 


new 

Line ( 

new 

string[] { 

"love，，，" 

they ", 

"apples, 

"eating" 

}, 

2 ) , 


new 

Line ( 

new 

string[] { 

"whistled 

[• ，，， "Bump" }, 1 ) 
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Use join to combine two collections into owe sequence 

Jimmy’s got a whole collection of comics he’s purchased, and he wants to compare them with the prices he 
found from sales on Greg’s List to see if the prices he’s been paying are better or worse. He’s been tracking 
his purchases using a Purchase class with two automatic properties, Issue and Price. And he’s got a 
List<Purchase> called purchases that’s got all the comics he’s bought. But now he needs to match 
up the purchases he’s made with the prices he found on Greg’s List. How’s he going to do it? 

LINQ to the rescue! Its join keyword lets you combine data from two sources using a single 
query. It does it by comparing items in one sequence with their matching items in a second sequence. 
(LINQ is smart enough to do this efficiently — it doesn’t actually compare every pair of items unless it 
has to.) The final result combines every pair that matches. 


o 


Start off your query with the usual from clause. 

But instead of following it up with the criteria it’ll 
use to determine what goes into the results, you add: 

join name in collection 

The join clause tells LINQ to loop through both 
collections to match up pairs with one member from 
each collection. It assigns name to the member it’ll 
pull out of the joined collection in each iteration. 
You’ll use that name in the where clause. 


Jirwmy s joihihg his domids 
"to a list o( 

hcs bought. 


Jimmy S V^»S data m a coWtcho^ ^ 
puvtV^asc objects tailed fu^r^ascs. 



class Purchase { 
public int Issue 

{ get; set, 
public decimal Price 
{ get; set, 







equals 


❺ You’ll continue the LINQ query 
with where and or derby 
clauses as usual. You could finish 
it with a normal select clause, 
but you usually want to return 
results that pull some data from 
one collection and other data 
from the other. That’s where 
you use select new to create 
a custom set of results using an 
anonymous type. 


on comic.Issue 

purchase.Issue 

The sclcd*t is -Pol I owed 

by duvly bvadkets *tha 七 
dorrtam i\\t data *to 
v-C*tu\nr^ m v-csul*U- 


Next you’ll add the on clause, which 
tells LINQ how to match the two 
collections together. You’ll follow it 
with the name of the member of 
the first collection you’re matching, 
followed by equals and the name of 
the member of the second collection to 
match it up with. 





results I ^ 


select new { comic.Name A 
comic.Issue, purchase.Price } 

Issue = 61 Name = "Johnny America" I Price = 3600 
19 I Name = "Rocl^ndRoir^Price = 375 

5^1 Name = "Hippie Madness" I Price = 13215 


Flip to leftover #9 in the appendix to 
learn more about anonymous types! 


you are here 
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jimmy’s a joiner 


Jimmy saved a bunch of dough 


It looks like Jimmy drives a hard bargain. This query creates a list of 
Purchase classes that contain his purchases, and compares them 
with the prices he found from recent sales on Greg’s List. 


o 


❹ 


FIISST JIMMYC12BATBt> HIS TO J 夕 IN- 

Jimmy already had his first collection — he just used his BuildCatalog () method from before. So 
all he had to do was write a FindPurchases () method to build his list of Purchase classes. 


This is a s-taiid 
rwcihod m the 
Pu\rdhasc dlass. 


public static 工 Enumerable<Purchase> FindPurchases() 
List<Purchase> purchases = new List<Purchase> () 


new 

Purchase() 

{ Issue = 

= 68, 

Price 

= 225M 

}, 

new 

Purchase() 

{ Issue = 

= 19, 

Price 

—. 375M 

}, 

new 

Purchase() 

{ Issue = 

= 6, 

Price ― 

3600M 


new 

Purchase () 

{ Issue = 

= 57, 

Price 

=13215M 

new 

Purchase() 

{ Issue = 

: 36, 

Price 

= 6 60M 



paid 

-fom issue 



return purchases; 

} 

N^>\aJ HB CAN t>0 THB JOlNl 

You’ve seen all the parts of this query already.. .now here they are, put together in one piece. 

IEnumerable<Comic> comics = BuildCatalog(); 

Dictionary<int, decimal 〉 values = GetPrices(); 

工 Enumerable<Purchase> purchases = Purchase.FindPurchases(); 

var results = Oiw'W'Y 3 L-l 

from comic in comics tom\>av-cd cvev-y m tom,6s ，oyv 

join purchase in purchases \ catK \itrr m \>uV-tKascs *to see v/KitK 

on comic • 工 ssue equals purchase • Issue ^ vc Co^\\C Issue C^udl "to fuvt^asc-Issue- 

orderby comic • 工 ssue ascending 

select new { comic.Name, comic • 工 ssue, purchase.Price 
decimal gregsListValue = 0; 

decimal totalSpent = 0; v , , ^ -- … w", 

foreach (var result in results) { ^" 0 你 "the rhCrwbc\r, 

gregsListValue += values [result. Issue] ; -rvom puv-dhasc rwcrubcv-. 
totalSpent += result.Price; 

Console .WriteLine (’'Issue #{0} ({1}) bought for { 2 : c}", 

result • 工 ssue, result.Name, result.Price); 

} 

Console•WriteLine ( n 工 spent {0:c} on comics worth {l:c} n , 

totalSpent, gregsListValue); 


、 pure 

traits a v-csull set with /Va^c 


Jimmys veal iiappy 
*tiia 七 k kr\ov/s LI I s / 公， 
because i*t lc*b him 
see just i^o>M iiav-d a 
bav^^dm lie dv-ivcf 
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Output: 

Issue #6 (Johnny America vs. the Pinko) bought for $3,600.00 


Issue #19 
Issue #36 
Issue #57 
Issue #68 


(Rock and Roll (limited edition)) bought for $375.00 
(Woman's Work) bought for $660.00 

(Hippie Madness (misprinted)) bought for $13,215.00 
(Revenge of the New Wave Freak (damaged)) bought for $225.00 


I spent $18,075.00 on comics worth $18,525.00 





querying data and building apps with LINQ 


BULLET POINTS - 

■ The group clause tells LINQ to group the 
results together—when you use it, LINQ creates a 
sequence of group sequences. 

■ Every group contains members that have one 
member in common, called the group's key. Use 
the by keyword to specify the key for the group. 
Each group sequence has a Key member that 
contains the group’s key. 

■ join queries use an on...equals clause to tell 
LINQ how to match the pairs of items. 

■ Use a join clause to tell LINQ to combine two 
collections into a single query. When you do, LINQ 


compares every member of the first collection with 
every member of the second collection, including 
the matching pairs in the results. 

■ When you’re doing a join query, you usually 
want a set of results that includes some members 
from the first collection and other members from the 
second collection. The select clause lets you 
build custom results from both of them. 

■ You can use select new to construct custom 
LINQ query results that include only the items that 
you want in your result sequence. 



Add the last two LINQ queries to Jimmy’s app. 


ADD TNB COtA\CQ\^^X TO Upt>ATeAVAiUAaue^ueisiesO* 

Update the AvailableQueries object initializer to instantiate two new ComicQuery 
objects so they get added to the main page. Here’s what the new buttons should look like: 


Cay\ y ou 

ou 七 *to w»akc 

i\\t title -tell 

Jimmy ^o>N V>c 
邛⑼七 Kov/ W'UtK 

七 hey y/ov-*tK? 

❺ 




Group comics by price range 

Combine Jimmy's values into groups 

Jimmy buys a lot of cheap comic books, some midrange comic books, and a few expensive ones, 
and he wants to know what his options are before he decides what comics to buy. 


Join purchases with prices 

Let's see if Jimmy drives a hard bargain 

This query creates a list of Purchase classes that contain Jimmy's purchases and compares them with 
the prices he found on Greg's List 


ADD MBTH^DS lO BXB6UTB THB 夕 U5RI5S AND UPDATB THB OUTPUT^ 

You’ll also need the Purchases class and EvaluatePrice () method from a 
few pages ago, and don’t forget to add the PriceRange enum to the project. Add 
EvaluatePrice () as a static method to the Purchases class. 


^ ADD THB MBW ^UBRIBS TO Upt>ATe^uei2YeesuuTsO^ 

Once you add the two new query methods to the switch statement in 
UpdateQueryResuits, you’re in business. 


you are here ► 
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no dumb queries 


I don’t quite get how join works. 

join works with any two sequences. 
Let’s say you’ve got a collection of football 
players called players— its items are 
objects that have a Name property, a 
Position property, and a Number 
property. So we could pull out the players 
whose jerseys have a number bigger than 
10 with this query: 

var results = 
from player in players 
where player.Number > 10 
select player; 

Let’s say we wanted to figure out each 
player's shirt size, and we’ve got a 
j erseys collection whose items have a 
Number property and a Size property. A 
join would work really well for that: 

var results = 
from player in players 
where player.Number > 10 
join shirt in j erseys 
on player.Number 
equals shirt.Number 
select shirt; 

Hold on, that query will just give 
me a bunch of shirts. What if I want to 
connect each player to his shirt size, and 
I don’t care about his number at all? 

A! That’s what anonymous types are 
for—you can construct an anonymous type 
that only has the data you want in it. And it 
lets you pick and choose from the various 
collections that you’re joining together, too. 

So you can select the player’s name and the 
shirt’s size, and nothing else: 



var results = 
from player in players 
where player.Number > 10 
join shirt in j erseys 
on player.Number 
equals shirt.Number 
select new { 

player.Name A 
shirt.Size 


The IDE is smart enough to figure out exactly 
what results you’ll be creating with your 
query. If you create a loop to enumerate 
through the results, as soon as you type 
the variable name the IDE will pop up an 
IntelliSense list. 


foreach (var r in results) 


r. 


Equals 

GetHashCode 

GetType 



3 - Size 
一 ToString 


Notice how the list has Name and Size in 
it. If you added more items to the select 
clause, they’d show up in the list too. That’s 
because the query would create a different 
anonymous type with different members. 

Can you rewind a minute and 
explain what var is again? 

Yes, definitely. The var keyword 
solves a tricky problem that LINQ brings 
with it. Normally, when you call a method 
or execute a statement, it's absolutely clear 
what types you’re working with. If you’ve 
got a method that returns a string, for 
instance, then you can only store its results 
in a string variable or field. 


But LINQ isn’t quite so simple. When you 
build a LINQ statement, it might return an 
anonymous type that isn’t defined anywhere 
in your program. Yes, you know that it’s going 
to be a sequence of some sort. But what 
kind of sequence will it be? You don’t know— 
because the objects that are contained in the 
sequence depend entirely on what you put in 
your LINQ query. Take this query, for example, 
from Jimmy’s program: 

var mostExpensive = 
from comic in comics 
where 

values[comic.Issue] 

> 500 
orderby 

values[comic•Issue] 
descending 
select comic; 

What if you changed the last line to this: 

select new 
{ Name = comic.Name A 

工 ssueNumber = ’▼#’▼ + 
comic.Issue }; 

That returns a perfectly valid type: an 
anonymous type with two members, a 
string called Name and a string called 
I ssueNumber. But we don’t have a 
class definition for that type anywhere in our 
program! Sure, you don’t actually need to 
run the program to see exactly how that type 
is defined. But the mostExpensive 
variable still needs to be declared with some 
type. 

And that’s why C# gives us the var 
keyword, which tells the compiler, “OK, we 
know that this is a valid type, but we can't 
exactly tell you what it is right now. So why 
don’t you just figure that out yourself and not 
bother us with it? Thanks so much.” 
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querying data and building apps with LINQ 



Here’s the code you need to add to Jimmy’s app to make the last two LINQ queries show up. 


private void UpdateAvailableQueries() { 

AvailableQueries = new ObservableCollection<ComicQuery> { 

new ComicQuery (，'LINQ makes queries easy，'，"A sample query ", 
"Let' s show Jimmy how flexible LINQ is ’，， 
CreateImageFromAssets( n purple_250x250.jpg n )), 


new ComicQuery("Expensive comics ", "Comics over $500 n , 

"Comics whose value is over 500 bucks." 

+ " Jimmy can use this to figure out which comics are most coveted. M , 
CreatelmageFromAssets("captain_amazing_250x250.jpg ")), 


new ComicQuery( n LINQ is versatile 1 M , "Modify every item returned from the query ", 
"This code will add a string onto the end of each string in an array. n , 
CreatelmageFromAssets ( n bluegray_250x250. jpg '，））， 

new ComicQuery("LINQ is versatile 2 ", "Perform calculations on collections '，， 
'’LINQ provides extension methods for your collections (and anything else" 

+ " that implements 工 Enumerable<T >).", 

CreatelmageFromAssets( n purple_250x250•jpg n )), 

new ComicQuery( n LINQ is versatile 3 M , 

"Store all or part of your results in a new sequence ", 

"Sometimes you'll want to keep your results from a LINQ query around .", 
CreatelmageFromAssets (’ 'bluegray—SSOxSSO. jpg '，））， 


new ComicQuery("Group comics by price range ”， 

"Combine Jimmy' s values into groups M , 

n Jimmy buys a lot of cheap comic books , some midrange comic books, and" 

+ n a few expensive ones, and he wants to know what his options are" 
+ " before he decides what comics to buy . n , 


CreatelmageFromAssets (▼▼ cap tain 一 amazing—250x250 • jpg")), 


new ComicQuery("Join purchases with prices", 

’ ’Let's see if Jimmy drives a hard bargain" 


these *bw。objcdts 

•to Ava'ilablc^ucv-ics object inrbal’z^r 

,/ causes -bKcm -to sKov/ uf Oh -bKc mam 阿 . 


"This query creates a list of Purchase classes that contain Jimmy's purchases" 


+ " and compares them with the prices he found on Greg's List.", 
CreatelmageFromAssets( n captain 一 amazing 一 250x250•jpg")), 


you are here ► 
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exercise solution 



内 jRciSe 

§PLjitlOH 


Wert av-C *thc Y\C^I 
dases -fov *thc sy/i*tdh 

sta*temwt that 匕 all 

•the ^ucv-y methods. 


public void UpdateQueryResuits(ComicQuery query) { 
Title = query.Title; 




switch (query.Title) { 

case，'LINQ makes queries easy" : LinqMakesQueriesEasy (); 
case "Expensive comics" : ExpensiveComics(); break; 
case，'LINQ is versatile 1" : LinqlsVersatilel () ; break; 
case ’ 'LINQ is versatile 2" : LinqIsVersatile2(); break; 
case n LINQ is versatile 3" : LinqIsVersatile3(); break; 
case "Group comics by price range" : 

CombineJiiranysValuesIntoGroups (); 
break; 


case "Join purchases with prices" : 
JoinPurchasesWithPrices(); 
break; 


Pv-i^cRahgc chum. 


enum PriceRange 


Cheap, Midrange, Expensive } 


class Purchase { 

public int Issue { get; set; } 
public decimal Price { get; set; } 


HevVs 七 he 
Puvdhasc dldss. 
EvaluatcPv-idcO 


is y\o^i B s-tatifi. 

rwethod \y\ the 
dlass. 


public static 工 Enumerable<Purchase> FindPurchases() 

{ 

List<Purchase> purchases = new List<Purchase> () { 


new 

Purchase() 

{ Issue = 

: 68, 

Price 

= 225M 

}, 

new 

Purchase () 

{ Issue = 

= 19, 

Price 

— 37 5M 

}, 

new 

Purchase() 

{ Issue = 

= 6, 

Price = 

3600M 


new 

Purchase() 

{ Issue = 

= 57, 

Price 

=13215M 

new 

Purchase() 

{ Issue = 

: 36, 

Price 

= 66 OM 



return purchases; 


public static PriceRange EvaluatePrice(decimal price) 

{ 

if (price < 100M) return PriceRange.Cheap; 

else if (price < 1000M) return PriceRange.Midrange; 

else return PriceRange.Expensive; 


break; 
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private void CombineJimmysValuesIntoGroups() { 

Dictionary<int, decimal 〉 values = GetPrices(); 
var priceGroups = 

from pair in values 

group pair.Key by Purchase.EvaluatePrice(pair.Value) 
into priceGroup 

orderby priceGroup.Key descending 
select priceGroup; 

foreach (var group in priceGroups) { 

string message = String•Format (” 工 found {0} {1} comics : issues ", 

group•Count(), group.Key); 

foreach (var price in group) 

message += price.ToString() + ""; 

CurrentQueryResuits.Add( 

CreateAnonymousListViewItem(message, M captain_amazing_250x250.jpg")); 


private void JoinPurchasesWithPrices() { 

工 Enumerable<Comic> comics = BuildCatalog(); 

Dictionary<int, decimal 〉 values = GetPrices(); 

工 Enumerable<Purchase> purchases = Purchase.FindPurchases() 
var results = 


I 

Wert avc 

— methods v/VtV) 

如 L 陶 


from comic in comics 

join purchase in purchases 

on comic • 工 ssue equals purchase • 工 ssue 

orderby comic • 工 ssue ascending 


c^UCVlCS. 


select new { 

Comic = comic. 

Price = purchase•Price, 

Title = comic.Name, 

Subtitle = ’'Issue #" + comic • 工 ssue. 

Description = String.Format("Bought for {0:c} n , purchase.Price ), 
工 mage = CreatelmageFromAssets( n captain—amazing_250x250.jpg"), 


decimal gregsListValue = 0; 
decimal totalSpent = 0; 
foreach (var result in results) { 

gregsListValue += values[result•Comic • 工 ssue]; 
totalSpent += result.Price; 

CurrentQueryResuits.Add(result); 

} 

Title = String•Format ( n 工 spent {0:c} on comics worth 
totalSpent, gregsListValue); 




The page title is bouhd b> 
■the Title p\ropc\rty ih the 

Corni ⑽ ueryA/laha ， object, 

so "this lihC will Aahy i 七 "to 
d message tcllihg Jimmy how 
你 udh he speh-t ay\d how 
the ^orwi^s wo\rth. 


you are here ► 
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pinch your data 


Use semantic zoom to navigate your data 

It’s great to give Jimmy an overview of his collection, but let’s give him a way 
to really drill down into the details. There’s a very useful control that will let 
you add an extra dimension to your app’s navigation. The semantic zoom 
is a scrollable control that lets your user switch between two different views of 
a sequence of data: a “zoomed out” view that shows an overview of the data, 
and a “zoomed in” view that shows more detail for each item in the sequence. 


Use the button in 
the simulator to put 
it into pinch/zoom 
mode. Hold down 
the mouse button 
and use the scroll 
wheel to simulate 
pinch/zoom. 



Pinch to zoom in 


Y^u use pmdh -fco zoom m 
如 d oui of 七 he semahiid zoom 
匕 0 的 — 0 |, jusi like you pmdh -to 
zoom you\r pho-fcos ov\ you\r 
ov* "tablet Yo\a d I so use "the 
scroll wheel oy dlidk ov\ rterws. 


Semantic zoom 
allows you to display 
two diHerent views 
oi tke same sequence 
oi data ： a zoomect — 
out view tkat skows 
many items, and a 
zoomect-in view tkat 
skows more detail. 


You can learn more about how semantic zoom fits into your apps here: 
htto://msdn.microsoft.com/en-us 川 brarv/windows/ai3Ds/hh465319.asi3X 
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querying data and building apps with LINQ 


Here’s the basic XAML pattern for the semantic zoom control. It uses a ListView or 
GridView control for the zoomed-out view, and another one for the zoomed-in view: 

<SemanticZoom IsZoomedInViewActive= n False" > 

<SemanticZoom.ZoomedOutView> 

<ListView> 

<!-- This section contains a ListView or GridView 
to show the zoomed out overview view --> 


</ListView> 

</SemanticZoom.ZoomedOutView> 
<SemanticZoom. ZoomedInView> 
<GridView> 


The GridView control is a lot like 
ListView. The main difference is 
that the ListView control scrolls its 
items vertically, while the GridView 
scrolls its items horizontally. 


<!-- This ListView or GridView shows 


the zoomed zoomed in detail view --> 
<GridView.ItemTemplate> 


Both the zoomed-in 
and zoomed-out views 
contain a ListView or 
GridView control with 
a data template that 
contains controls to 
make the view work. 


<DataTemplate> 

<!—— This ListView or GridView in this section 
shows the zoomed in detail view ——> 
</DataTemplate> 

〈/GridView • ItemTemplate> ’ ^ a L\siV\^ ^ the 

zoomed-ou-t view ahd a (^v-idl/icw ^o\T 

</GridView> ihc 一 “ U you ^ 


</SemanticZoom.ZoomedInView> 


Cithcir OhC -Po\r cithcv- the 


use 
views. 


</SemanticZoom> 


LisWiow and ^vid\/ic>M i—C 你⑶七 ☆ 你 arrtidZ* 。。 你 Ijovma 七 ion 

The S ⑽ ▲TW 仏士 。 U 扣 ― 仏山 m to^broU that imfle 了七七巧 ☆ 广七 ’〒 M 

Udk*,k you do^-b to Mau you^l^. U w used 

L\siV\Jb> Show the 如撕以 - OU 七 如心 ad a 駟 d\/ wb S 一惋⑽一 - m • 七⑽ s. 


you are here 




it’s all semantics 


Add semantic zoom to Jimmy's app 

Jimmy would love to be able to see all of the comics in his collection, and 
zoom in on individual comics to see details. 



O ADD A N5W ITEM lO TH5 MAIN PA^B. 

Jimmy needs something to click on, so the first thing you’ll do is add a new item to return all of the 
comics in the collection. First, add a method to ComicQueryManager to show all of the comics: 

private void AllComics() { 

foreach (Comic comic in BuildCatalog()) { 

var result = new { 

工 mage = CreatelmageFromAssets( n captain_amazing_zoom_250x250•jpg n ), 
Title = comic.Name, 

Subtitle = ’'Issue #" + comic •工 ssue. 

Description = "The Captain versus " + comic.MainVillain, 

Comic = comic, 

}； 

CurrentQueryResuits.Add(result); 



Next, add a new case to the switch statement in UpdateQueryResuits (): 
case "All comics in the collection" : AllComics(); break; 


And finish it off by adding a new ComicQuery object to the collection initializer in 

UpdateAvailableQueries () . You’ll also need to add the captain_amazing_zoom_250x250.jpg image to the 
Assets/ folder. 


new ComicQuery("All comics in the collection ", 


"Get all of the comics in the collection ", 
"This query returns all of the comics ", 




CreatelmageFromAssets("captain—amazing_zoom_250x250.jpg n )), 


Download 

this 

■file -P\rorw -the 


ADD M^>125 P12^P512TI5S TO TH5 CO/^\C CLASS. 

Semantic zoom only makes sense if you have details to zoom in on. It’ll still be displaying Comic 
objects from the ComicQueryManager . Cur rentQueryRe suits collection, so we just need to 
add those details to the Comic class and make sure to bind to those new properties in the zoomed-in 
view. 


Head Fi\rs-(： 
C 养 wcbsi-tc. 


using Windows•UI•Xaml.Media.Imaging; 


class Comic { 

public string Name { get; set; } 
public int Issue { get; set; } 
public int Year { get; set; } 
public string CoverPrice { get; set; } 
public string Synopsis { get; set; } 
public string MainVillain { get; set; } 
public Bitmaplmage Cover { get; set; } 
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O ADD thb detailed conk\c data. 

Modify the BuildCatalog () method to add more details about each comic. You’ll also need to add images 
of the covers to your project’s Assets. Download them from http:/ / www.headfirstlabs.com/hfcsharp. 

public static 工 Enumerable<Comic> BuildCatalog() { 
return new List<Comic> { 

new Comic { Name = "Johnny America vs. the Pinko", 工 ssue = 6, Year = 1949, CoverPrice = ”10 cents", 
MainVillain = "The Pinko", Cover = CreatelmageFromAssets("Captain Amazing Issue 6 cover.png "), 
Synopsis = "Captain Amazing must save America from Communists as The Pinko and his" 

+ M communist henchmen threaten to take over Fort Knox and steal all of the nation's gold. M }, 

new Comic { Name = "Rock and Roll (limited edition) M , 工 ssue = 19, Year = 1957, CoverPrice = "10 cents", 
MainVillain = "Doctor Vortran ", Cover = CreatelmageFromAssets("Captain Amazing Issue 19 cover.png "), 
Synopsis = "Doctor Vortran wreaks havoc with the nation's youth with his radio wave device that" 

+ M uses the latest dance craze to send rock and roll fans into a mind-control trance. M }, 


new Comic { Name = "Woman's Work ”， Issue = 36, Year = 1968, CoverPrice = "12 cents", 

MainVillain = "Hysterianna ", Cover = CreatelmageFromAssets(’’Captain Amazing Issue 36 cover.png "), 
Synopsis = "The Captain faces his first female foe, Hysterianna, whose incredible telepathic" 

+ M and telekinetic abilities have allowed her to raise an all-girl army that" 

+ M even the Captain has trouble resisting. M }, 


new Comic { Name = "Hippie Madness (misprinted) M , 工 ssue = 57, Year = 1973, CoverPrice = "20 cents", 
MainVillain = "The Mayor ", Cover = CreatelmageFromAssets(’’Captain Amazing 工 ssue 57 cover.png"), 
Synopsis = M A zombie apocalypse threatens Objectville when The Mayor rigs the election by M 
+ M introducing his zombification agent into the city's cigarette supply. M }, 

new Comic { Name = "Revenge of the New Wave Freak (damaged) 11 , 工 ssue = 68, Year = 1984, 

CoverPrice = M 75 cents ", MainVillain = "The Swindler", 

Cover = CreatelmageFromAssets (’’Captain Amazing 工 ssue 68 cover .png "), 

Synopsis = M A tainted batch of eye makeup turns Dr. Alvin Mudd into the Captain's new nemesis, M 
+ M in The Swindler's first appearance in a Captain Amazing comic. M }, 

new Comic { Name = "Black Monday" , 工 ssue = 74, Year = 1986, CoverPrice = M 75 cents ", 

MainVillain = "The Mayor ", Cover = CreatelmageFromAssets("Captain Amazing 工 ssue 74 cover.png "), 
Synopsis = "The Mayor returns to throw Objectville into a financial crisis by directing his M 
+ M zombie creation powers to the floor of the Objectville Stock Exchange. M }, 

new Comic { Name = "Tribal Tattoo Madness" , 工 ssue = 83, Year = 1996, CoverPrice = "Two bucks ", 

MainVillain = "Mokey Man ", Cover = CreatelmageFromAssets('’Captain Amazing 工 ssue 83 cover.png "), 
Synopsis = "Monkey Man escapes from his island prison and wreaks havoc with his circus sideshow" 
+ M of tattooed henchmen that and their deadly grunge ray. M }, 


new Comic { Name = "The Death of an Object", 工 ssue = 97, Year = 2013, CoverPrice = "Four bucks", 

MainVillain = "The Swindler ", Cover = CreatelmageFromAssets("Captain Amazing 工 ssue 97 cover.png "), 
Synopsis = "The Swindler's clone army attacks Objectville in a ruse to trap and kill the M 
+ ▼▼ Captain. Can the scientists of Objectville find a way to bring him back?" }, 

Flip the pa^e to finish Ae 卿 - 

you are here ► 
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drilling down into the details 


O ADD A N5W BASIC PA^B T^> HOLD TH5 SEMANTIC ZOO^A 

Jimmy’s happy with the rest of the app, so instead of modifying the existing page, we’ll add a whole 
new page. Add a new Basic Page called QueryDetailZoom.xaml. 

Once it’s added, go back to MainPage.xami and modify its ItemClick event handler in the 

code-behind to navigate to a QueryDetailZoom page if the user clicks on the newly added query: 

private void ListView—ItemClick(object sender, 工 temClickEventArgs e) { 
ComicQuery query = e•Clickedltem as ComicQuery; 
if (query != null) { 

if (query.Title == "All comics in the collection") 

this.Frame.Navigate(typeof(QueryDetailZoom), query); 

else 

this.Frame.Navigate(typeof(QueryDetail), query); 

} V. Weve’s the new 1-temClidk eve«i handlev -for 

|七 dhcdks -the "title o( -the ^ucv-y -fco see i-f i-t should hdvi^a-te 
■to a ^ucvyDc-tail o\r QueryDetailZoom page. 

O AC>C> A STATIC C^>Mic6?ueisyMAN^eis E5S^>U1265 TO TH5 N5W PA^B. 

The new QueryDetailZoom page works exactly like the existing QueryDetail page. You’ll 
need to add a ComicQueryManager to the〈Page • Resources〉section of QueryDetailZoom.xaml. 

You don’t need to update the AppName resource because the page will set that using G# code: 

<Page.Resources 〉 

<local : ComicQueryManager x:Name= n ComicQueryManager M /> 

<!-- TODO : Delete this line if the key AppName is declared in App.xaml --> 
<x : String x : Key="AppName">My Application</x : String> 

</Page.Resources 〉 

O ADD TH5 COD5 — BEHIND TH5 N5W DETAIL PA^B. 

And you’ll need to add exactly the same OnNavigatedTo () method to QueryDetailZoom.xaml.cs: 

protected override void OnNavigatedTo(NavigationEventArgs e) { 

ComicQuery comicQuery = e.Parameter as ComicQuery; 
if (comicQuery != null) { 

ComicQueryManager.UpdateQueryResults(comicQuery); 
pageTitle.Text = ComicQueryManager.Title; 

} 

base.OnNavigatedTo(e); 
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6125AT5 TH5 XAMU TH5 N5W D5TAIU PA^B. 

There’s just one more thing you need to do: build out the XAML for the QueryDetailZoom.xaml page so 
that it contains a semantic zoom control that displays the comic book details. It’s the biggest page you’ve 
created so far, so we’ve spread the code across two pages to make it easier for you to understand what’s 
going on. 


<Grid Grid.Row="1" Margin= n 120,0 n 

DataContext= M {StaticResource ResourceKey=comicQueryManager} n > 


<Grid.RowDefinitions> 

<RowDefinition Height="Auto" / > 
<RowDefinition/> 

</Grid.RowDefinitions> 


Wt，}rc the a gHd 

vov/make su\rc that its Listl/i C w a^d 
^v-idl/icw ^ohtirols sdvoll. 


<TextBlock Style="{StaticResource SubheaderTextStyle}" Margin= n 0,0,0,20 

Text= M Pinch to zoom in or out" / > 


<SemanticZoom 工 sZoomedInViewActive= n False n Grid.Row="1"> 


The zoomed—out 
view is 3 Lis*t\/icv/ 
•that’s c%ad*tly like 

■the OY\t OY\ 七 he 



〈 SemanticZoom•ZoomedOutView> 

<ListView 工 temsSource= n {Binding CurrentQueryResults}" Margin= n 0,0,20,0 

ItemTemplate= n {StaticResource Standard500xl30ltemTemplate} 
SelectionMode= M None" / > 

</SemanticZoom.ZoomedOutView> 


^ucvyPctail fajc- 

<SemanticZoom.ZoomedInView> 


<GridView 工 temsSource 二 n {Binding CurrentQueryResults}" 

Margin="0,0,20,0" SelectionMode="None" x : Name= M detailGridView M > 
<GridView. 工 temTemplate 〉 



The ioorwed—m view is 


bdsed ov\ d ^\rid\/icy/. 

lis data ic^pla-tc is 


<DataTemplate> 

<Grid Height="7 80" Width= M 600" Margin= M 10"> 
<Grid.ColumnDefinitions> 

<ColumnDefinition Width="Auto" / > 
<ColumnDefinition/> 

</Grid.ColumnDefinitions> 


The ^vidl/icw^s daia -template 
wov-ks jus*t like Lis*t\/icy/. Flip bd^k 
*to Chapter lO *bo v-crw'md youv-scl-P 
how daia -templates v/ork. 


3 J'rid "tha-t 6o»vtams 
6o>vbrol 

-Po\r ihc CoMtY artd 


〈Image Source:，'{Binding Comic . Cover} " Margin= n 0,0,20,0 n 
Stretch="UniformToFill" Width= M 326" Height= M 500" 
VerticalAlignment="Top M / > 


a Sta^kPa^d o( 


the o*thcv* pvopc\rtics. 


Flip the pa^e for iiie rest of the comic detail Xj^VLL. - ► 


you are here ► 
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jimmy’s thrilled 


<StackPanel Grid.Column= M l"> 


*bhc V-CS*t *thc 

今 \rid\/icv/s i*tcw\ 

•for *thc zoomed—m view. 
I 七 displays the \rcs*t o-f 
the details’m a set o-f 
Tc^tBlo^k do^*tv-ols 七 

av-c bou^d *to pv-opc\rtics 
oy\ *thc Comi£. object- 


<TextBlock Text= M Name M 

Style="{StaticResource CaptionTextStyle}" /> 

<TextBlock Text="{Binding Comic.Name}" 

Style="{StaticResource 工 temTextStyle}" /> 

<TextBlock Text= " 工 ssue" 

Style="{StaticResource CaptionTextStyle}" Margin 二 , '0,10,0,0 n /> 
<TextBlock Text=" {Binding Comic • 工 ssue}，' 

Style="{StaticResource 工 temTextStyle}" /> 

<TextBlock Text="Year" 

Style="{StaticResource CaptionTextStyle}" Margin= n 0,10,0,0 n /> 
<TextBlock Text="{Binding Comic.Year}" 

Style="{StaticResource 工 temTextStyle}" /> 


<TextBlock Text= M Cover Price" 

Style 二 , '{StaticResource CaptionTextStyle}" Margin= n 0,10,0,0 ▼’ /> 
<TextBlock Text="{Binding Comic.CoverPrice}" 

Style="{StaticResource 工 temTextStyle}" /> 


<TextBlock Text= M Main Villain" 

Style="{StaticResource CaptionTextStyle}" Margin= n 0,10,0,0 n /> 
<TextBlock Text="{Binding Comic.MainVillain}" 

Style="{StaticResource 工 temTextStyle}" /> 


<TextBlock Text= M Synopsis" 

Style="{StaticResource CaptionTextStyle}" Margin= n 0,10,0,0 n /> 
<TextBlock Text="{Binding Comic.Synopsis}" 

Style="{StaticResource 工 temTextStyle}" /> 

</StackPanel> 

</Grid> 


</DataTemplate> 
</GridView. 工 temTemplate> 
</GridView> 

</SemanticZoom.ZoomedInView> 
</SemanticZoom> 

</Grid> 


二^二 、。 ㈣ c : 
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You made Jimmy's day 

Thanks to the new app you built, Jimmy has 
his collection totally organized. Nice work! 


® All comics in the collection 


-B 


Pinch to zoom in or out 


^ ri • 

r 

fj£ • *>« • 

r. Mm. 

Ht 

mmm 


Name 

Black Monday 

Issue 

74 

Yw 

1966 

Cowr Price 

75 cents 

Mdiri Villiiin 

The Mayor 

Synopsis 

The Mayor returns to throw Objectville 
into a finarYdal crisis by directing his 
zombie creation powers to the floor of 
the Objectville Stock Exchange. 


㈣ 


，— ii 



Name 

Tribal Tattoo Madness 

Issue 

83 

Year 

1996 

Covrr Pricp 

Two bucks 

Mdin Vdldiri 

Mokey Man 

Synopsis 

Monkey Man escapes from 
prison and wreaks Kavoc w 
sideshow of tattooed henc 
and th^ir deadly grunge ra 


A 

C5 

0 

© 

CB 

0 



THIS IS THE BEST 
THIN^ TO HAPPBM SlbiCB 
工 F^UMD THAT LIMITED 
EDITION EBPEINT O? ISSUE 
#23 AT A SAUB 

^MUY FIVE BUCKSL 
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split the difference 


The IPE’s Split App template helps you build 
apps for navigating data 


There’s an easier way to build two-page apps that navigate between overview and 
detail pages to display grouped items. When you create a new project using the 
Split App template, the IDE automatically creates a project that lets the user 
navigate between an overview items page and a split page with the details. We can 
explore the Split App template by adapting the app that you built for Jimmy to use it. 



this 

參 



Create a new Split App project and run it. 

The Split App project template contains a class that generates sample data, which means that 
you can actually run it as soon as it’s created. 


Create a new Split App (XAML) project and name it Ji 

namespaces match the code on the next few pages. 


LysComicsSplitApp so the 


New Project 


P Recent 
J Installed 

J Templates 
t> JavaScript 
Visual Basic 
J Visual C# 

Windows Store 
P Visual C+ + 
Samples 

l> Online 


Sort bys Default 

BlankApp (XAML) 

Grid App [XAML] 

■ ■■ 

Split App [XAML] 

fri 

m 
m 


Visual C# 

Visual C# 

Visual C# 


c# 


Class Library (Windows Store.., Visual C# 
Windows Runtime Component Visual C# 
Unit Test Library [Windows St... Visual C# 


Name: 
Location:: 
Solution name: 


Jim mysComi csSp litApp 


c:\Users\Public\DocumentsWisual Studio Z012\Projects\ 
JimmysComicsSplitApp 


Search Installed Templates (Ctrl+E) 
Type: Visual C# 


p 


A two-page project for a Windows Store 
app that navigates among grouped items. 
The first page allows group selection while 
the second displays an item list alongside 
details for the selected item. 



Browse... 


[^| Create directo ry for solution 
Add to source control 


□ K 

Cancel 



Change the app name to “Jimmy’s Comics” using the AppName resource. In projects created 
with the Split App project template, the AppName resource is in the App.xaml file: 

<x : String x : Key="AppName">Jimmy's Comics</x:String 〉 


692 


Chapter 14 






























































querying data and building apps with LINQ 


Now run the app. A Split App has two pages. 
The first page is the items page, which shows 
you groups of items that you can drill down into: 




The XAML for the items page is 
in the ItemsPage.xaml file. The 
XAML for the page is setup 
to display groups using the 
Standard250x250ltemTemplate, 
which is in StandardStyles.xaml in 
the Common folder. 



Solution Explorer 


ii 


<> 


P 


Click on one of the items to navigate to the split page: 



(Si T © ^ 4 ^ Q 

Search Solution Explorer (Ctrl+;) 

Solution 'JimmysComicsSplitApp' (1 project) 
|cil JimmysComicsSplitApp 
> A Properties 
References 
篇 Assets 
篇 Common 
DataModel 


D App.xaml 

ltemsPage.xaml 

|E] JimmysComicsSplitApp_TemporaryKey.pfx 
ftil Package.appxmanifest 
SplitPage.xaml 


fi ， 


Clicking on an item in the items page 
causes the app to navigate to the split 
page, which is in SplitPage.xaml. It displays 
the contents of the group on the left using 
the familiar Standardl 30ltemTemplate. 
Details for the selected item are displayed 
on the right. This just uses plain XAML with 
data binding, and not a template. 


Itpm Conlcnl: Cuiabilui class dlk|uarn vcslit>uluin nam 
phasdlus susprnilkM.' qtiisquc ckuK-c dis pracscnl accmns. 
condimentum odipiscing ctinm conscqu.it vivwimk dicliiimt alquam di«s rom 
est partuncrt ullamcofpcf aliquet iuscc suspendisse nunc hac eleitcnd amct bl 
coodimentum commodo scelefisque faucibus aenean uilarrK0fp«f ante mauris 
c(MH«ctetuet riullain loiem v«slibulunt tubilanl conubia elementum peilent«vc 
MiKcilutiin dumi cutiilui aplent 4iido( «jrl |>rflef<le\q 

i-<ir\l.n inliKiinii conwlrliirf minimikIiw' 


•idipiM -19 ptrlktilirvqiio (Mtiin lolxxln 


TKc Idr^e blodk o( is a sm^lc Tt%id\ock, 
youll vcf lade *m S*tcf y/*rtv> )<AML 

Code -from youv* app 七 hat displays dom'id dc*t 3 iU. 


itxtur dass abquam vvslibulum nam curae maecenas s< 
donee ds potruml accumsan bAwndum p«Hh*nte» 


integer cias phas«Hus suspendissc 
v condimenlum adipisong eUam 


it abquam duis cortvaliis sceletisque «l paituii«ii( ullamcoipei al 


fustc wnpcndisvc nunc Ka< ckMcnd amcl bittndil l< 
tauribus aciwar ulatncorpcr ante mauris dignissim 
habitant comibia elementum pelleiitesque morbi fa 
vcstibulum aoclor eget dapibus pdlenlcsquc iivxp 
suspendis&e adipiscing pellenlesque pioin lotxxtis : 
parturient ftlnqilla euismod feugaal 


tllMtimH ci 
qtiisquc <1oi 


11 (ld«% —(Mm vrvlibuluin ivniiuiiiie nueci 
donocAs prscscnt dccumuo txbcndum pci 
idl vniamus dictumst dhqudm <tuis convallis v 
_pndiss« rwnc Kac eteifend amet btandit fac 
aenean ulamcoipef ante inauiis digniMim c 
conubia elemenluin ptHlerUcsque morbi (ac 
jm audor eget (tapibtis pdlenlcsquc inceplr 
lissc adipiscing pcllcnicsquc pfom lobMlis x 


.lied integci (m 、pKneHus Mn|N?iKlivM? 
esque condimenlum adipiscing ctwm 
risque cst parturient ulldmcorpcr aliquet 
condimentum commodo Ketorisque 
eclelun iiullam kxiftii veslibutum 
aicu sollkitudiri diam cubKa aptent 
o <x)«;tas intcfchim nulla con&cclclucf 


Cuiabilut da» 4liquam veslibulom nan» (uiae maeten« sed integer cia» phaieduv MispendiH« 
quisque donee dn piaesent accumun bibendum pelentesque condimenlum adiptscing eliam 
(«Mnc<]u<il vnnami、<lklumvt obqiMr" <iui、（.uovnlh、\celenvjije evl [Mitufiml ulUrruoipef <iIk]u 
lince MnpcrKlivM? mine ^mc efeileiKi wivn tiiandil Imifevi (umliinriiliiiT) <aiiviKxk) welriivjuc 
toiritMK acrMMn ulnmcotpcr ante miMm' digniruim roiMettcfiiCf niilUim locran vcvtibulum 
habitant conubia elementum pdlcntcsquc morbt tac4«s arcu soIlKitudin d>am cubika dptent 
vestibolum aocor eget dapibus pHienlesque inceptos »eo egestas intercKim nulla consectduer 
suspendisse adipiscirig pellerilestfue pioin lotxxtis solbciludin au^ie efct mus corigue («mentt 


susperKJis&« adipisdrig pellenlesqui 
parturienl fringilb euismod fvugial 


m taoiois arcu soIlKitudin d<am cubika aptent 
ccptosleo egestas interdum nulla consectctuer 
itis solbcitudin ajgue elil mus congue fctmentuni 


Curabilur dass abquam ycslibulom nam curae maecenas sed integer eras ptvKcBus suspendisse 
quisque donee ds praoseot accumsao Mjcndum pdent«qi« condimentum achp 
cons«qua( vivamjs dictumst aliquam duis coovallis scelerisqoe est parturient ullarr 
fince MKperidiue iwnc Kx eteifend amel blandit ladiii condimenlum conwituclo 
favKibus aenean uiwncwper ante inauiis diqniisim consecleltw< nullam kxe*n v« 

conuliM f)rtli-iilcvHK- moibi Uolniv 刖 （u \allKitti(lin dirfin ail 


fuice Mispendiu 
faucibus a«n«a(i 


ilum nam curac macccn« sed integer eras ptvtsdliis suspendisse 
rumsan tMbcrtdum pdent«qi*e condimentum adip<scing eliam 
iquam duis coovallis scelerisque est parturient ullamcorper aliquet 


parturient fringilla cuismod 
Cuiabitut (lass ahquarn wsl 


snluin pHIcnlnquc moibi («cilius «i(u sollkituclin <lbnn cubilM «plrnt 
dapib«K pHlenlcitjiic inccptof teo cqmim tnterrtum null« fomefleliier 
pelInntcMiuc prom loboclK Mlbcitudin auguc «ht m»it conguc tementum 
mod Icugul 


Cuiabitut (lass ahquarn wstibulwn nam cuiae mseemas sed inleqei etas phasdhA Mnpendissc 
qiihqucf donet ds ptarswil accuimdd Miendum pHhriitnque condimenlum adipisciog eliam 
(：CNH«]iial vivanius dictumst aliquarn duis corivallis Mclcfisquc cst pdiluiimt ullarmoipci aliquel 


The )<mL ihc 

spirt page displays 七 he 
detail scd*tior> o^ly yj\\cv\ 

"the 灼 is vo-t^-ted "to 

fo\rt\rait V^>u C^y\ bry 
"this youvscl-P- v*un -the app 
in -tljfsiirwulai^jr d^d use 
'the BS di^d Bfi birtto^s 
"to \rotaic the simulated 
device- 


you are here ► 
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same data new app 




New Item... Ctrl+Shifts A 

Existing Item... Shift+Alt+A 

New Folder 

Class... Shift+Alt+C 


❺ Add data classes to the DataModel folder. 

Right-click on the DataModel folder in the Solution Explorer and choose Add^Glass... to add a 
new class to the folder. 


企 T © ▼ # « 


Search Solution Explorer (Ctrk;) 

EJI Solution 'JimmysComicsSplitApp' (1 project) 
a @ JimmysComicsSplitApp 

> A Properties 

> References 

> _ Assets 

> m Common 


m 

p 




> c 翁 SampleDataSource.es 

> D App.xaml 

> <0 ltemsPage.xaml 

p] JimmysComicsSplitApp_TemporaryKey.pfx 
Ifel Package.appxmanifest 

> ^ SplitPage.xaml 


Create the ComicQueryManager class. When you create a class inside a folder, the IDE 
automatically generates it using a namespace that includes the folder name: 

namespace JimmysComicsSplitApp.DataModel 

{ 

class ComicQueryManager 

{ 




Copy the contents of the ComicQueryManager class 
from your working Jimmy’s Comics app and paste them 
into the newly generated Comic.cs file in the DataModel folder. 
Make sure you keep the JimmysComicsSplitApp . 
DataModel namespace — and don’t forget the using 
statement. 

Next, repeat the same steps to create the Comic, 
ComicQuery, and Purchase classes, as well as the 
PriceRange enum. They should all be created inside the 
DataModel folder, which means they should all be in the same 
JimmysComicsSplitApp. DataModel namespace. 
Here’s what your Solution Explorer should look like after the 
files are all added: - ► 


b - 泛 Q 濯 W <> 多 

Search Solution Explorer [Ctrl+;) 

Solution 'JimmysComicsSplitApp' [1 project) 
J [c§ J im mysCom icsS ptitApp 

> jfr Properties 

> References 

> Assets 

> _ Common 
J £] DataModel 

> C w Comic.cs 

> C w ComicQuery.cs 

> PriceRange.es 

> Purchase.cs 

> SampleDataSource.es 


P 


▲ 


▼ 


Add 


Scope to This 

New Solution Explorer View 



Exclude From Project 



Cut 

Ctrl.X 


Copy 

Ctrl+C 

X 

Delete 

Del 

D£:::i 

Rename 

F2 


Open Folder in File Explorer 



A Properties 


P 


P 


ComiiicQu eryM anager.es 


orer 


So ution 


Solution Explorer 


■•□ + a-^V 
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There was already a file inside the DataModel folder called 
SampleDataSource.es ， which contains code to generate all of the 
sample data that you saw when you ran the app. 

Open it up — it actually works a lot like the data classes 
app you built for Jimmy. The file contains several classes, 
including a SampleDataGroup class (which represents 
higher-level groups, similar to your ComicQuery class) and 
a Sample Data Item class (which represents individual items, 
like your Comic class). The actual sample data is created in 
the constructor of the Sample Da taSource class at the very 
bottom of the file. 



The code-behind for the items page creates a new instance 
of the SampleDataSource class, and uses it to populate a 
dictionary called Def aultViewModel. 


^oJW leav*^ mov*c 
abou-t v/hd-t B 

\/icwModd is a^d 
how "to build ov\t 
Chap 七 I 厶 . 


m 


O 


o 


VOAIT A MINUTBi 
IF THB DATA THB COtA\C APP IS 

STRUCTURED UIICB TN5 SAMPUB DATA, 
IT SHOULD BB BASY TO ADD IT TO THB 
SPUIT APP. 



That’s right. The Split App template is built 
to make it easy for you to add your data. 

All you need to do to get your data into the Split App is make 
a few tweaks to the code-behind in the items page and split 
page, so that’s what we’ll do next. We’ll also modify the split 
page so that it uses the same XAML to display the comic 
book cover and information in the detail page. 
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your app’s todo list 




❹ 


CorwrwCh"t 
out these 

lihCS. 


Add this lihC 




Modify the code-behind in ItemsPage.xaml.es. 

Open ItemsPanelxaml.cs and use Edit^Find and Replace to search for “TODO:” in the 
code. Have a look at the comments — the template is letting you know that this is where you 
replace the sample data. Comment out the next two lines that set the Items value in the 
Def aultViewModel dictionary, and replace them with your own code that reads the 
AvailableQueries property from a new ComicQueryManager object: 

// TODO: Create an appropriate data model for your problem domain to replace the sample data 
//var sampleDataGroups = SampleDataSource.GetGroups((String)navigationParameter); 

/ / this. Def aultViewModel [" 工 terns ▼▼ ] = sampleDataGroups; 

this•DefaultViewModel[ n Items ▼'] = new DataModel.ComicQueryManager() .AvailableQueries; 



You’ll also need to comment out the code in the I temView_ItemClick () event handler 
method, which attempts to cast the item that was clicked on to the SampleDataGroup type (it’s 
passed into the event arguments as e . Clickedltem). The AvailableQueries property 
returns a collection of GomicQuery objects, so here’s the new ItemClick () event handler: 


void 工 temView 一工 temClick(object sender, 工 temClickEventArgs e) { 

// Navigate to the appropriate destination page, configuring the new page 
//by passing required information as a navigation parameter 
/ /var groupld = ((SampleDataGroup) e.Clickedltem) • Uniqueld; 

// this.Frame.Navigate (typeof (SplitPage), groupld); 

DataModel.ComicQuery query = e.Clickedltem as DataModel.ComicQuery; 
if (query != null) 

this.Frame.Navigate(typeof(SplitPage) , query); 



Modify the code-behind in SplitPage.xaml.es. 

The split page also has a comment with “TODO:” in the code, right above statements that 
set the Group and Items values in the Def aultViewModel dictionary. Replace them 
with code to set the group and items for the page using your comic book data model: 


Vo\a d\rcaicd 
Corwid^ucv-y 
ihc oihev- 
dasses ’m 七 he 

Da-ta/V]odcl 

-folder so -they 
live ’m 七 he 
Data/Wodcl 


// TODO : Create an appropriate data model for your problem domain to replace the sample data 
// var group = SampleDataSource.GetGroup((String)navigationParameter); 

// this.DefaultViewModel["Group"] = group; 

// this • DefaultViewModel [ n Items n ] = group • 工 terns; 

DataModel.ComicQueryManager ComicQueryManager = new DataModel.ComicQueryManager(); 
DataModel.ComicQuery query = navigationParameter as DataModel.ComicQuery; 
ComicQueryManager.UpdateQueryResults(query); 
this.DefaultViewModel["Group"] = query; 

this.DefaultViewModel[ '’Items n ] = ComicQueryManager.CurrentQueryResults; 


There’s one other thing you need to do. The split page overrides the SaveState method, which 
allows it to remember which item was clicked on. The code that’s generated casts the selected item 
to SampleDataltem, so comment out all of the code in the method to avoid casting exceptions. 

protected override void SaveState(Dictionary<String, Obj ect> pageState) { 

// Comment out all of the code in this method 
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0 Add the image files to the Assets folder. 

You’ll need all of the image files from the app you built for Jimmy. 
Right-click on the Assets folder and choose Add^Existing 
Item... to bring up the Add Existing Item window. Navigate to the 
folder that has the code for the app you created earlier in the chapter 
and use Control-click to multiselect all of the files except for Logo.png, 
SmallLogo.png, SplashScreen.png, and StoreLogo.png. Click Add to add all of 
the files to your project’s Assets folder. 


Your app now runs! The items page 
displays the available queries from 
the ComicQueryManager object... 


Jimmy's Comics 


■ , 

|Q QSH 



Search Solution Explorer (Ctrl+;) fi 

Solution 'JimmysComicsSplitApp' (1 project) 

a 回 JimmysComicsSplitApp 


> A Properties 

> References 



0 bluegray_250x250.jpg 
0 Captain Amazing Issue 19 cover.png 
0 Captain Amazing Issue 36 cover.png 
0 Captain Amazing Issue 57 cover.png 
0 Captain Amazing Issue 6 cover.png 
曰 Captain Amazing Issue 68 cover.png 
S Captain Amazing Issue 74 cover.png 
0 Captain Amazing Issue 83 cover.png 
0 Captain Amazing Issue 97 cover.png 
0 captain_amazing_250x250.jpg 
0 captain_amazing_zoom_250x250.jpg 
0 DarkGray.png 
0 LightGray.png 
0 Logo.png 
0 MediumGray.png 
0 purple_250x250.jpg 
0 SmallLogo.png 
0 SplashScreen.png 
0 StoreLogo.png 

> 篇 Common ▼ 


...and the split page shows 
you the query results and 
lets you drill down into 
the details of each item. 


© Join purchases., 


59 

B3 




S 8 


Johnny America vs. the Pinko 

Bought for S3,600.00 


Rock and Roll (limited edition) 


Bought for S375.00 


Woman’s Work 

Issue #36 

Bought for $660.00 


Hippie Madness (misprinted) 

Issue #57 

Bought for $13.215.00 


Revenge of the New Wave Freak (damaged) 

Issue #68 

Bought for $22f>.00 


V 



Woman's Work 


displayed hcv-c 

bedause Tc^tBlodk -that shov/s 
■the details is bou^d *to a fv-ofev-ty 
called youv- qucv^ics 

do^*t v-c*tuv-^ objects that have -that 
fv-ofev-ty. Be^ov^e you -flip the ⑽ e 》 
*thmk about hov/ you display 


% 
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that was quick 

^ Modify SplitPage.xaml to show the comic book details. 

The XAML in SplitPage.xaml uses templates to display the items on the lefthand side of the split, 


but it just uses straightforward, out-of-the-box XAML with data binding to show the details for the 
selected item on the righthand side. It includes this TextBlock that’s bound to a Content property: 

〈TextBlock Grid.Row=’’2 〃 Grid. ColumnSpan=”2" Margin= 〃 0,20, 0, 0 〃 ^ 1 ^ 

Text=”{Binding Content} " Style= ,f {StaticResource BodyTextStyle} 〃/> 



these 


piropcvtics 
so "the Con\\t 


The sample data in SampleDataSource.es includes a Content property that contains a large block of 
text. But we want our app to display information about comics in Jimmy’s collection. Luckily, we 
already have a block of XAML that displays information nicely when it’s bound to a Comic object. 

Find the content TextBlock and replace it with the comic detail XAML. Make sure you 


appeals m -the 
same plate ov\ 
七 he pajc- 


add the Grid. Row, Grid. ColumnSpan, and Margin properties to the outer grid: 


<Grid Height= n 780" Width="600" Grid.Row= n 2" Grid.ColumnSpan= n 2" Margin= n 0,20,0,0 n > 

<Grid.ColumnDefinitions> 

<ColumnDefinition Width= M Auto" / > 

<ColumnDefinition/> 

</Grid.ColumnDefinitions> 

〈Image Source= M {Binding Comic.Cover}" Margin= n 0,0,20,0 n 
Stretch="UniformToFill" Width= M 326" Height= M 500" 
VerticalAlignment="Top M / > 

<StackPanel Grid.Column="1"> 


〈TextBlock Text= M Name" 

Style="{StaticResource CaptionTextStyle}" / > 
〈TextBlock Text= M {Binding Comic.Name}" 

Style="{StaticResource 工 temTextStyle} n /> 


<TextBlock Text="Issue" 

Style=" { StaticResource CaptionTextStyle } " Margin 二，， 0,10,0,0 n /> 
<TextBlock Text= n {Binding Comic • 工 ssue. Target}" 

Style="{StaticResource 工 temTextStyle} n /> 


<TextBlock Text= M Year M 

Style="{StaticResource CaptionTextStyle}" Margin 二， '0,10,0,0 n /> 
<TextBlock Text= M {Binding Comic.Year}" 

Style="{StaticResource 工 temTextStyle} n /> 


<TextBlock Text= M Cover Price" 

Style="{StaticResource CaptionTextStyle}" Margin= n 0,10,0,0 n /> 
〈TextBlock Text= M {Binding Comic.CoverPrice}" 

Style="{StaticResource 工 temTextStyle} n /> 


〈TextBlock Text= M Main Villain" 

Style="{StaticResource CaptionTextStyle}" Margin= n 0,10,0,0 n /> 
〈TextBlock Text= M {Binding Comic.MainVillain}" 

Style="{StaticResource 工 temTextStyle} n /> 


<TextBlock Text="Synopsis" 

Style= M {StaticResource CaptionTextStyle}" Margin= n 0,10,0,0 n /> 
<TextBlock Text="{Binding Comic.Synopsis}" 

Style= M {StaticResource 工 temTextStyle} n /> 

</StackPanel> 

</Grid> 
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querying data and building apps with LINQ 




Now your Split App lets you drill down into the results 
of any query that returns comics, displaying the 
details of the selected comic on the split page. 





Join purchases.. 


Johnny America vs. the Pinko 


Bought for $3,600.00 


Rock and Roll (limited edition) 


Bought for $375.00 


Woman’s Work 


Bought for $660.00 


Hippie Madness (misprinted) 

Issue #57 

Bought for $13,215.00 


Revenge of the New Wave Freak (damaged) 

Issue #68 

Bought for S22S.00 


Hippie Madness (misprinted) 


Issue #57 


Hippie Madness (misprinted) 


20 cents 

Main Villain 

Th« Mayor 

SynopsK 

A zombie apocalypse threatens 
Objectville when The Mayor rigs the 
election by introducing his 
zombification agent into the city's 
cigarette supply. 


W 


The £%pcJr>S*iVC 
Comics v-c*tuvy>s 

a o( — 

BY\OY\^n\ 0 \AS objCd*ts 
just Kavc Title 
ar\A fv-ofcvtics. 


Some of the queires don’t return a Comic, so any field bound to the 
field will be empty. In Chapter 16, you’ll learn about value converters, 
which you can use to hide these fields or display a default value. 


@ Expensive comics 


o 




國 


Hippie Madness (misprinted) is worth $13,525.00 



Johnny America vs. the Pinko is worth 
$ 3 , 600.00 



Woman's Work is worth $650.00 



These dojrrbrols bou 的 d "to 

pv-opcvtics that a\rc 的 at ’m 
the ddia doh-toc-t, so 七 hey 
shov/ up as bldhk oy \ -the 
Latcv- ih 七 he book, you II 
Icavh about "tools -that you 
use -to hide the labels or 
display a default value. 



You can also add pages to your project using Items Page and Split Page templates using the same Add New 
Item feature in the IDE that you use to add the Basic Page. And there’s another valuable template called Grid 
App that has three levels of navigation. You can learn more about the Grid App and Split App templates here: 

http://msdn.microsoft.com/en-us/library/windows/apps/hh768232.aspx 
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15 eVents and delegates 




What your code does when 

you’re not looking 



工 , D BBTTBE 
SUBSCEIBB TO THAT 
TiseeP^psUp^uT^FN^vjp4eise 
BVBMT, OR HAVE 
6AUU MY ^nB^kbnUbc^O 
METHOD. 





% 


Your objects are starting to think for themselves. 

You can’t always control what your objects are doing. Sometimes things...happen. And 
when they do, you want your objects to be smart enough to respond to anything that 
pops up. And that’s what events are all about. One object publishes an event, other 
objects subscribe, and everyone works together to keep things moving. Which is great, 
until you want your object to take control over who can listen. That’s when callbacks will 
come in handy. 


this is a new chapter 
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publisher，meet subscriber 


Ever wish your objects could thiwk for themselves? 


Suppose you’re writing a baseball simulator. You’re going to model a game, sell the 

software to the Yankees (they’ve got deep pockets, right?), and make a million bucks. Tha 七 ’s a dor^rwohly used v/ay 

You create your Ball, Pitcher, Umpire, and Fan objects, and a whole lot more. ^ 你 mc*t^ods—y/cll 

You even write code so that the Pitcher object can catch a ball. ^ '。代 abou 七 .rt la*tcv. 


Now you just need to connect everything together. You add an OnBall InPlay () 
method to Ball, and now you want your Pitcher object to respond with its event 
handler method. Once the methods are written, you just need to tie the separate 
methods together: 


acts tailed- 


J hc b f ^/it with a 10 — c 
，十 7 柊 ⑽ W pW^d i 仏 

9 0, ^9 to i\ravel 0Z feei 

^ l 

Ball•OnBalllnPlay( 70 , 82 ) 




r 


0 6jec 、 



We ^ 

卜 II 卜 n 
•t h，i a,d ih c dlsi3 ^ 


Pitcher.CatchBall() 


Put how does an object KNOW to respond? 

Here’s the problem. You really want your Ball object to only worry about 
getting hit, and your Pitcher object to only worry about catching balls 
that come its way. In other words, you really don’t want the Ball telling the 
Pitcher, “I’m coming to you.” 



巧 Ball doesh't khow whi^h 

+ield^ will pi^k it u P ..^ayb c i he 

匕⑽？饮 wybe the CaUhc^ 

°； ^ ^ who 

decided "to S^oo-fc/hO. 

TW^s docs^t ^ear. 






You want an 
object to worry 
about itself，not 


otker otjects. 
You’re separating 


tke concerns ol 
eacli otject. 
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events and delegates 


Whew aw EVENT occurs...objccts listen 

What you need to do when the ball is hit is to use an event. An event is simply 
something that，s happened in your program. Then, other objects can 
respond to that event — like our Pitcher object. 

Even better, more than one object can listen for events. So the Pitcher could 
listen for a ball-being-hit event, as well as a Catcher, a ThirdBaseman, an 
Umpire, even a Fan. And each object can respond to the event differently. 


event ， noun. 

a thing that happens ， 
especially something of 
importance. The solar 
eclipse was an amazing 
event to behold. 


So what we want is a Ball object that can raise an event. Then, we want 
to have other objects to subscribe to that particular type of event — that 
just means to listen for it，and to get notified when that event occurs. 

a ftall yts ^ objc^ ^subs^bld hCcd khow 

Wrt, 七 raises a 

— BalllnPlay event raised 



°A/ec^ 


Eveirrts look like 
bol*ts m -the IPE *too. 
You’ll see By\ \tor\ like 
-this *to cvcir\*ts \y\ 
|^*tclliSci^sc 'm 

p\rofc\rtics w'mdlow- 



、 ob 〆 、 0 bV C ' 



°A/ec^ ^ 


TV arxd oi\\€r 

olavcvs tv'/ *to 

U\A bail 


ahd what happehs. 


F(3h object 

subs^Hbcs ih ^se a ball 
9 ocs ^"to -the scats. 


Want to PO SOMETHING with aw 
event? You need an event handler 

Once your object “hears” about an event, you can set up some code to run. 
That code is called an event handler. An event handler gets information 
about the event, and runs every time that event occurs. 

Remember, all this happens without your intervention at runtime. So you 
write code to raise an event, and then you write code to handle those events, 
and fire up your application. Then, whenever an event is raised, your handler 
kicks into action.. .withoutyou doing anything. And, best of all, your objects have 
separate concerns. They’re worrying about themselves, not other objects. 








CoAt 
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if a tree falls in the woods... 


Owe object raise s its Gvcwt others listen for it... 

An event has a publisher and can have multiple subscribers. Let’s take 
a look at how events, event handlers, and subscriptions work in C#: 


(T) First, other objects subscribe to the event. 

Before the Ball can raise its BalllnPlay event, other objects need to 
subscribe to it. That’s their way of saying that any time a BalllnPlay 
event occurs, we want to know about it. 


Ewy object adds its 

Hahdlcv- *to lis-fcch -fov 
七 he cvcht—just like you add 
but-toh/_CI*ulkO io y< 

pv-ogv-a^s -to lis-fcch -fo 
cvch-fcs. 


ouv- 

浐 Clidk 




♦ 

◄- 


BalllnPlay event 



與 s. 






^a\\lrP\ av f 




Qn 6 of 




Something triggers an event. 

The ball gets hit. It’s time for the Ball object to raise a new event. 





SomC'tiW'CS wc II 

dbou 七 air\ 

ov- -f i*t> oV" mvokmj 

i*b—all same 
七 Wi ， People jus-b use 

names for it 




The ball raises an event. 

A new event gets raised (we’ll talk about exactly how that works in just a minute). That 
event also has some arguments, like the velocity of the ball, as well as its trajectory. 
Those arguments are attached to the event as an instance of an EventArgs object, 
and then the event is sent off, available to anyone listening for it. 



-► 





S ㈣ b t 刪帏 



BalllnPlay 

event 
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events and delegates 


Thcw, the other objects hawdlg the event 

Once an event is raised, all the objects subscribed to that event get 
notification, and can do something: 


(2) Subscribers get notification. 

Since the Pitcher, Umpire, and Fan object subscribed to the Ball 
object’s BallInPlay event, they all get notified — all of their event 
handler methods get called one after another. 



④ 



BalllnPlay eve 









7 




Ah cvcht hahdlcv is just the 

^cthod ih -the subsdvibc^ object 

tha-t gets iruh whch the cvcht is 

v-aised. 



/ts sooh as the ball raises its 

it a BallEv^-tA^s 

obje^-t wrth the ball S tvajc^Wy 
distah^c so it C，avy pass it -to 
七 he subs^ibcvs ； ever^i hdhdlm. 


^Qn 60 f 


Events a\rc h 扣 died cm a 
-Piv-s-t— donr»C| -fivs-t—sewed 
bdsis — "the objcd*t 七 

subsdv-ibcs -Piv-st <\cts 


Each object handles the event. ^ hoti-Picd -fivst 

Now, Pitcher, Umpire, and Fan can all handle the BalllnPlay event in their 
own way. But they don’t all run at the same time — their event handlers get called 
one after another, with a reference to a BallEventArgs object as its parameter. 





tA/kJ xL-kJ c^t /丄 lexm | ^ 


a 


BBSS" 



BalllnPlay eve 






▼ 






The Fah object ^hc^ks 
BallEvch-tAirgs -to see i-f 
"the ball is dlosc Chough 

io 乙 aM. 


The washes. H 叫託州 subs^ibc h> 

fY likc Bal1 化 Ided # BallT^ow,, 

to iuirthcir Yt^ti io what happen. 





°^jec\ 
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I came here for an argument 


Connecting the dots 


Now that you’ve got a handle on what’s going on, 
let’s take a closer look at how the pieces fit together. 

Luckily, there are only a few moving parts. i -、 J 

)0 d \dca (aVtW 欢？甙 p % 


① 


It’s a 


wcwbcvs- 


We need an object for the event arguments. 

Remember, our BallInPlay event has a few arguments that it 
carries along. So we need a very simple object for those arguments. 
.NET has a standard class for it called EventArgs, but that class 
has no members. Its sole purpose is to allow your event arguments 
object to be passed to the event handlers that use it. Here’s the class 
declaration: 


|t 70 U ^ 

m tasc you 

州 七 


class BallEventArgs : EventArgs 


The ball will use these 
pv-opc\rtics -to pass 
m-Pov*rwa-(：ioh "fco the 
CVCht holhdlcv-s about 
whc\rc the balls bcch hit- 





Next we’ll need to define the event in the class that’ll raise it. 

The ball class will have a line with the event keyword — this is how it informs other 
objects about the event, so they can subscribe to it. This line can be anywhere in the 
class — it’s usually near the property declarations. But as long as it’s in the Ball class, 
other objects can subscribe to a ball’s event. You saw the event keyword when you 
fired PropertyGhanged events. Here’s the BalllnPlay event declaration: 

public event EventHandler BalllnPlay; 


A-Ptcv- the cvcht keyword domes Bvchtttoihdlcv-. 
Tha-t s v\oi a C# keyword—i 仏 deemed 

as P 价七 J NET. The \rtasoy\ you Y\tt& it is io tell 
■the objects subs^ibihj -to the cveh-t whai i\\6r 
li3hdlc\r methods should look like. 



£vcir>*ts av*c usually fubl'id. This 

cvcv>*t is dc-f med Ball 

dass, bu 七 we’ll warrt Pi*t^Kcv-, 
Umfivc, *to be able *to 

vc-fcv*cr>dc i*t- V® u 乙 make 

•1 七 pv-Wa*tc i*f you or^ly >war>*tcd 
o*thcv *ms*tay>dcs o( same 

dlass bo subsdvibc {jo *i*t- 


you use Eveh 七 fUdl ⑺ youVc tdlmg olhev- methods ihai 
theiv* cvcht hahdlc\rs r\tt& -to take two pav-a^c-tcv-s ： av\ object 
hamed schdev* a^d av\ Ewt/Wy \rc-Pc\rchdc hdmed e- se^dev* is 


a iht objc^ that v-aised the cvcht ahd c 

>rt\tYty\U -to ah Bvch-tAv-gs object 


is 3 


706 Chapter 15 











events and delegates 


The subscribing classes need event handler methods. 

Every object that has to subscribe to the Ball’s BallInPlay event needs to have an 
event handler. You already know how event handlers work — every time you added a 
method to handle a button’s Click event or a NumericUpDown’s ValueChanged 
event, the IDE added an event handler method to your class. The Ball’s 
BalllnPlay event is no different, and an event handler for it should look pretty familiar: 


void ball BalllnPlay(object sender, EventArgs e 



T\\trts m C# v-ulc i\\ai says youv cvcr>*t i^dl^rs 
Y\ttd "to be hdvwcdi d £.cv**t3m s ^ 

pvc*t*ty s*tar\dav-d CoY\Mtv\hoY\' o-f 

•the object -followed by ur\dcvs£.ovc> 

-follov/cd by o-f cvcr\*t- 



The BalllnPlay eveirt lis-ted its 

"type 3s Evc^tta^dlcv", y/hidh medhs 七 1 ^七 i 七 r^ccds 
to take two pavarwetevs—objedi 匕 ailed sender 

and an called c—a^d have v\o v-ctuv^ 

value. 


The tlass 杻 at has *tKis partitulav /⑶七 
^dr>dle\r method Kas a Ball \rc-fcvcr>dc variable 
tailed ball so its BalllnPlay e 心七 \\a^A\tr 
stavts W\h\ “ball 」： ^olloy/cd by -tKc ok 
*t\ic cvcr\*t V^dled, w Ball|r\PUy . 


④ 


Each individual object subscribes to the event. 

Once we’ve got the event handler set up, the various Pitcher, Umpire, ThirdBaseman, and 
Fan objects need to hook up their own event handlers. Each one of them will have its own specific 
ball—Ball InPlay method that responds differently to the event. So if there’s a Ball object 
reference variable or field called ball, then the += operator will hook up the event handler: 


ball.BalllnPlay += new EventHandler(ball BalllnPlay); 



This "tells "to hook "the cvcht 

Kahdlc\r up -fco -the BalllnPlay 

〜 y 七 J whalcvcv- 。 1^ 匕七七 he ball 
vc-fcirchdc is poih-tihg to. 




The + 二 ofev-atov- tells 
C 养 *to subsdv-ibc Br\ 
cvc^*t iia^dlcv bo Bv\ 


TWis pavb sfcti-f'ics v/WitK 
cvcir\*b Kar\dlcv method *to 
substv-'ibc *to cvcrrt 

、 ， 

TV^c event V^a^dlcv method's sij^aWc 

(vU fav-a^ctev-s ar\d \rc*bu\nr\ value) has *to 

tv^c or^c deemed by Evc^tta^dlcv 

OV* {\\t fvoyam y/cw ’七 Compile. 


Thru the page； tfcere’s a little more. 


-► 
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don’t call me; i’ll call you 


^5^ A Ball object raises its event to notify subscribers that it’s in play. 

Now that the events are all set up, the Ball can raise its event in response to something else 
that happens in the simulator. Raising an event is easy — it just calls the BalllnPlay event. 

Even tHandl e r balllnPlay = BalllnPlay; ^ ^ • … 一 ， ^opcd -to a variable, 

t is a 

if (balllnPlay != null) ^^ BallEvdA^s objedt 
balllnPlay(this r e); 

㈣ & 


BalllnPL 

BalllhPlay is 
balllnPlay, y/ 

used h> \rdis< 


whidh is hull-dhc^kcd Sy\d 
^isc the CVCht. 


TVic ball yb Wrtxl 
Ball obje^ 50 CS 

nr^'to 3 乙七 10 於 … 










… a 灼 d 

^ass'»y\^ 

\i -to 

v-a"»scd- 

Wow the 


Watch it! 


BalllnPlay event 


° 6 jec^ 


丁 he pitdlicv- hooked up its 
广 evehi ha^dlcv- -to the ball’s 

Y BalllhPlay cvcht. 


CVCht is 
active. Whos 
subscribed? 



^obp 


^ ^ i 0 >uVat ^ 
avxA 


If you raise an 
event with no 
handlers, it’ll 
throw an 
exception. 


If no other objects have 
added their event handlers 
to an event, it’ll be null. So 
always check to make sure 
your event handler isn’t 
equal to null before you raise 
it If you don’t, it’ll throw a 

NullReferenceException. 

That’s also why you should 
copy the event to a variable 

before you check to see if it’s 
null — in extremely rare cases, 
the event can become null 
between the null check and 
the time that it’s called. 


Use a standard name when you add a method to raise an event 


Take a minute and go to the code for any page in a Windows Store app, and type the keyword override any 
place you’d declare a method. As soon as you press space, an IntelliSense window pops up: 


override 


(1)* OnDoubleTappedCDoubleTappedRoutedEventArgs e] 
OnDragEnter[DragEventArgs. e) 

◦ n Drag Lea ve(D rag EventArgs e) 

OnDragOver[DragEventArgs e) 

© + OnDropfDragEventArgs e] 

OnGotFocusfRoutedEventArgs e) 


|\/otidc hoy/ tacM of iKcsc methods -takes 

£vcir>*tA^5 s su kla ss as a 
TKcy all pass *tha*t fav-amc*tcv- oy \ {p 七 he 

CVCir>*t >whcir> V 3 ISC i*t- 


There are a huge number of events that a XAML Page object can raise, and every one of them has its own 
method that raises it. The page’s OnDoubleTapped () raises the DoubleTappedEvent event (which 
it inherits from a superclass called UIElement), and that’s the whole reason it’s there. So the Ball event 
will follow the same convention: we’ll make sure it has a method called OnBallInPlay that takes a 
BallEventArgs object as a parameter. The baseball simulator will call that method any time it needs the 
ball to raise its Ball InPlay event — so when the simulator detects that the bat hit the ball, it’ll create a new 
instance of BallEventArgs with the ball’s trajectory and distance and pass it to OnBall InPlay () • 
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events and delegates 


theretcire no o 

Dumb QjuestiQns 


Why do I need to include the word 
EventHandler when I declare an 
event? I thought the event handler was 
what the other objects used to subscribe 
to the events. 

That’s true—when you need to 
subscribe to an event, you write a method 
called an event handler. But did you notice 
how we used EventHandler in the 
event declaration (step #2) and in the line 
to subscribe the event handler to it (step 
#4)? What EventHandler does is 
define the signature of the event—it tells 
the objects subscribing to the event exactly 
how they need to define their event handler 
methods. Specifically, it says that if you want 
to subscribe a method to this event, it needs 
to take two parameters (an obj ect and 
an EventArgs reference) and have a 
void return value. 

What happens if I try to use a 
method that doesn’t match the ones that 
are defined by EventHandler? 

A〕Then your program won't compile. 

The compiler will make sure that you 
don’t ever accidentally subscribe an 
incompatible event handler method to an 
event. That’s why the standard event handler, 
EventHandler, is so useful—as soon 
as you see it, you know exactly what your 
event handler method needs to look like. 

Wait, “standard” event handler? 
There are other kinds of event handlers? 

A! Yes! Your events don’t have to 
send an object and an EventArgs. 


In fact, they can send anything at all—or 
nothing at all! Look at the IntelliSense 
window at the bottom of the facing page. 

Notice how the OnDragEnter 
method takes a DragEventArgs 
reference instead of an EventArgs 
reference? DragEventArgs 
inherits from EventArgs, just 
like BallEventArgs does. The 
page’s DragDrop event doesn’t use 
EventHandler. It uses something else, 
DragEventHandler, and if you want 
to handle it, your event handler method needs 
to take an object and a DragEventArgs 
reference. 

The parameters of the event are defined 
by a delegate— Even tHandler 
and DragEventHandler are two 
examples of delegates. But we'll talk more 
about that in a minute. 

So I can probably have my event 
handlers return something other than 
void, too, right? 

Well, you can, but it’s often a bad idea. 
If you don’t return void from your handler, 
you can’t chain event handlers. That means 
you can’t connect more than one handler 
to each event. Since chaining is a handy 
feature, you’d do best to always return 
void from your event handlers. 

Chaining? What’s that? 

A! It’s how more than one object can 
subscribe to the same event—they chain 
their event handlers onto the event, one after 
another. We’ll talk a lot more about that in a 
minute, too. 


Is that why I used += when when 
I added my event handler? Like l，m 
somehow adding a new handler to 
existing handlers? 

A! Exactly! Any time you add an event 
handler, you want to use +=■ That way, your 
handler doesn’t replace existing handlers. 

It just becomes one in what may be a very 
long chain of other event handlers, all of 
which are listening to the same event. 

Why does the ball use “this” when 
it raises the BalllnPlay () event? 

Because that’s the first parameter 
of the standard event handler. Have you 
noticed how every Click event handler 
method has a parameter “object sender ”？ 
That parameter is a reference to the 
object that’s raising the event. So if 
you’re handling a button click, sender 
points to the button that was clicked. And 
if you’re handling a BalllnPlay 
event, sender will point to the Ball 
object that’s in play—and the ball sets that 
parameter to this when it raises the event. 


A SINGLE event is 

always raised ty a 

SINGLE otject. 

But a SINGLE 

event can l>e 
responcted to hy 

MULTIPLE oUeds. 
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that’ll save you some typing 


The IPE generates event handlers for you automatically 


Many programmers follow the same convention for naming their event handlers. If 
there’s a Ball object that has a BalllnPlay event and the name of the reference 
holding the object is called ball, then the event handler would typically be named 
ball_BallInPlay () . That’s not a hard-and-fast rule, but if you write your code 
like that, it’ll be a lot easier for other programmers to read. 


Luckily, the IDE makes it really easy to name your event handlers this way. It has a 
feature that automatically adds event handler methods for you when you’re 
working with a class that raises an event. It shouldn’t be too surprising that the IDE can 
do this for you — after all, this is exactly what it does when you double-click on a button 
in the designer. (This may seem familiar because you’ve done it in earlier chapters.) 

③ Start a new blank Windows Store app and add the Ball and BaiiEventlArgs, 

Here’s the Ball class: 



class Ball { 

public event EventHandler BalllnPlay; 
public void OnBalllnPlay(BallEventArgs e) { 
EventHandler balllnPlay = BalllnPlay; 
if (balllnPlay != null) 
balllnPlay(this, e); 


And here’s the BallEventArgs class: 

class BallEventArgs : EventArgs { 

public int Trajectory { get; private set; } 

public int Distance { get; private set; } 
public BallEventArgs(int trajectory, int distance) { 
this•Trajectory = trajectory; 
this.Distance = distance; 


❺ Start adding the Pitcher’s constructor. 

Add a new Pitcher class to your project. Then give it a constructor that takes a Ball reference 
called ball as a parameter. There will be one line of code in the constructor to add its event 
handler to ball .BalllnPlay. Start typing the statement, but don’t type += yet. 

public Pitcher(Ball ball) { 
ball.BalllnPlay 
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0 Type += and the IDE will finish the statement for you. 

As soon as you type += in the statement, the IDE displays a very useful little box: 

public Pitcher (Ball ball) { 

ball•BalllnPlay += 

} ball_Ba[[lnPLay; (Press TAB to insert) 

When you press the Tab key, the IDE will finish the statement for you. It’ll look like this: 

public Pitcher (Ball ball) { 

ball.BalllnPlay += ball—BalllnPlay; 



The IDE will add your event handler, too. 

You’re not done — you still need to add a method to chain onto the event. Luckily, the IDE takes care 
of that for you, too. After the IDE finishes the statement, it shows you another box: 

ball • BallInPlay += ball BalllnPlav> 

Press TAB to generate handler 'balLBalllnPlay' in this class 

Hit the Tab key again to make the IDE add this event handler method to your Pitcher class. The 
IDE will always follow the ob j ectName_HandlerName () convention: 


void ball—BalllnPlay(object sender, EventArgs e) { 


throw new NotlmplementedException(); 


TKc IPS always f ills m 七 Wis 

as a platcKoldcv, 

so i-f you \rur. toAt itll ^ 

七 ha 七 -tells you Aa 七 you still r\tt& *to i 叶 1 加伙七 

•'t billed 


o Finish the pitcher’s event handler. 

Now that you’ve got the event handler’s skeleton added to your class, fill in the rest of its code. The 
pitcher should catch any low balls; otherwise, he covers first base. S’mde Ball£vch-tA^3 s ,s 3 subdlass o( 

void ball—BalllnPlay (obj ect sender, EventArgs e) { js, wc II dow^das*t i*t us*m^ 

if (e is BallEventArgs) { 《 as kcy>/oV"d so y/C use i*ts p\ropcv**tic 

BallEventArgs ballEventArgs = e as BallEventArgs ; 

if ((ballEventArgs.Distance < 95) && (ballEventArgs.Trajectory < 60)) 

CatchBall (); 


else 


CoverFirstBase(); 


V® U； H 3idd these methods 
m a rw'mu-tc. 


you are here 
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put it all together 



It’s time to put what you’ve learned so far into practice. Your job is to complete the Ball and 
Pitcher classes, add a Fan class, and make sure they all work together with a very basic 
version of your baseball simulator. 


O CO/^PLBJB TH5 Prrc^ CLASS. 

Below is what we’ve got for Pitcher. Add the CatchBall () and CoverFirstBase () 
methods. Both should create a string saying that the catcher has either caught the ball or run 
to first base, and add that string to a public ObservableCollection<string> called 
PitcherSays. 


class Pitcher { 

public Pitcher (Ball ball) { 

ball•BalllnPlay += new EventHandler(ball—BalllnPlay); 

} _ 

void ball—BalllnPlay(object sender, EventArgs e) { 
if (e is BallEventArgs){ 

BallEventArgs ballEventArgs = e as BallEventArgs; 

if ((ballEventArgs.Distance < 95) && (ballEventArgs.Trajectory < 60)) 

CatchBall (); ? 

else rv ☆u’ll Y\ttd *to *thcsc two 

CoverFirstBase () ; J 、 methods *to add a *to *thc 

} Pi*tdhcvSays Obscv-vablcCollcttio^. 


O VJ12IT5 A Fan CLASS. 

Create another class called Fan. Fan should also subscribe to the BalllnPlay event in its 
constructor. The fan’s event handler should see if the distance is greater than 400 feet and the 
trajectory is greater than 30 (a home run), and grab for a glove to try to catch the ball if it is. If 
not, the fan should scream and yell. Everything that the fan screams and yells should be added 
to an ObservableCollection<string> called FanSays. 

L Look -the output Oh the 
page -to see exactly 
what should p\rih"t. 



°^jec\ 
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O BUIUD A V512Y SIMPU5 SIMULATE. 

If you didn’t do it already, create a new Windows Store Blank App, replace MainPage.xaml with a Basic 
Page, and add the following Baseball Simulator class. Then add it as a static resource to the page. 

using System.Collections.ObjectModel; 


class BaseballSimulator { 

private Ball ball = new Ball(); 
private Pitcher pitcher; 
private Fan fan; 

public ObservableCollection<string> FanSays { get { return fan.FanSays; } } 

public ObservableCollection<string> PitcherSays { get { return pitcher.PitcherSays; } } 



public int Trajectory { get; set; } 
public int Distance { get; set; } 

public BaseballSimulator() { 

pitcher = new Pitcher(ball); 
fan = new Fan(ball); 


public void PlayBall() { 

BallEventArgs ballEventArgs = new BallEventArgs(Trajectory, Distance); 
ball.OnBalllnPlay(ballEventArgs); 


BUIUD TH5 MAIN PA 他 

Gan you come up with the XAML 
just from looking at the screenshot to 
the right? The two TextBox controls 
are bound to the Tra j ectory 
and Distance properties of the 
BaseballSimulator static 
resource, and the pitcher and fan 
chatter are ListView controls bound to 
the two ObservableCollections. 

See if you can make your simulator 
generate the above fan and pitcher 
chatter with three successive balls put 
into play. Write down the values you 
used to get the result below: 


Trajectory 

Pitcher says 


Pitch #1:1 covered first base 

Distance 

Pitch #2:1 caught the ball 


Pitch #3:1 covered first base 



Play ball! 

Fan says 

iwt -Povgc-t the 
Click cvcht handle 

-the bu-t-toh. 

Pitch #1: Woo-hoo! Yeah! 

Pitch #2: Woo-hoo! Yeahi 
：\r 

Pitch #3: Home run! I'm going for the bail! 


Ball 1: 

Trajectory: 


Ball 2: 

Trajectory: 


Ball 3: 

Trajectory: 


Distance: 


Distance: 


Distance: 
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exercise solution 






It’s time to put what you’ve learned so far into practice. Your job is to complete the Ball and 
Pitcher classes, add a Fan class, and make sure they all work together with a very basic 
version of your baseball simulator. 


Here are the Ball and BallEventArgs from earlier, and the new Fan class that needed to be added: 

class Ball { 

public event EventHandler BalllnPlay; 
public void OnBalllnPlay(BallEventArgs e) { 

EventHandler balllnPlay = BalllnPlay; 
if (balllnPlay != null) 
balllnPlay(this, e); 



Read-only 

auiomati^ 

p\ropc\rtics 
>/ov-k \rcally 
y/cll m 

bedause 

•the cvc 灼 *t 

ha^dlcv-s oY\\y 
v-cad 七 he 
dlaia passed 
*bo them- 


class BallEventArgs : EventArgs { 

public int Trajectory { get; private set; } 
public int Distance { get; private set; } 
public BallEventArgs(int trajectory, int distance) 
{ 

this.Trajectory = trajectory; 
this.Distance = distance; 


"The OhBalllhPlayO rwethod jus-t v-aiscs 
the BalllhPlay cve^-t—but it has 

"to -to su\re it’s hot hull; 

otherwise, i-tll thv-ow ah cx^p-tioh. 


using System.Collections.ObjectModel; 

class Fan { 

public ObservableCollection<string> FanSays = new ObservableCollection<string>(); 
private int pitchNunt)er = 0; ^ objc^S 

public Fan (Ball ball) { ^ ^V^a'mS »*U handler 

ball .BalllnPlay += new EventHandler (ball—BalllnPlay) ; o^*to 


The (av\s BalllhPlay 

cvcht hdhdleir looks 
-Pov- ar\y ball that’s 
and lo^^- 


void ball—BalllnPlay(object sender, EventArgs e) { 
pitchNumber++; 
if (e is BallEventArgs) { 

BallEventArgs ballEventArgs = e as BallEventArgs; 
if (ballEventArgs.Distance > 400 && ballEventArgs.Trajectory > 30) 
FanSays.Add("Pitch # M + pitchNumber 

+ M : Home run! I'm going for the ball !’’）； 

else 

FanSays .Add ("Pitch # M + pitchNumber + M : Woo-hoo! Yeah !’’）； 



The only code-behind that the page needs is this But ton 一 Click () event handler method: 

private void Button_Click(object sender, RoutedEventArgs e) { 

baseballSimulator.PlayBall (); 
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This s-btid. \rcsouv-^c goes ih 

Ragc Rcsou\r^cs sc^tioh. events and delegates 


Here ? S the XAML for the page. It also needs： <local: Baseball Simulator X : Name= "baseball Simulator" / > 


<Grid Grid.Row= M 1 M Margin= M 120 , 0 M DataContext= M {StaticResource ResourceKey=baseballSimulator} M > 

<Grid.ColumnDefinitions> 

<ColumnDefinition Width= M 200 M / > 

<ColumnDefinition/> 

〈 /Grid.ColumnDefinitions> 

<StackPanel Margin= n 0,0,40,0 n > 

<TextBlock Text= M Trajectory" Style= M {StaticResource GroupHeaderTextStyle} M Margin= n 0,0,0,20 n /> 
<TextBox Text= M {Binding Trajectory, Mode=TwoWay} M Margin= n 0,0,0,20 n /> 

<TextBlock Text= M Distance" Style= M {StaticResource GroupHeaderTextStyle} M Margin= n 0,0,0,20 n /> 
<TextBox Text= M {Binding Distance, Mode=TwoWay} M Margin= n 0,0,0,20 n /> 

<Button Content= M Play ball!” Click= M Button_Click M / > 

</StackPanel> 

<StackPanel Grid.Column= M 1 M > 

<TextBlock Text= M Pitcher says M Style= M {StaticResource GroupHeaderTextStyle} M Margin= n 0,0,0,20 n /> 
<ListView 工 temsSource= n {Binding PitcherSays} M Height= M 150 M / > 

<TextBlock Text= M Fan says M Style= M {StaticResource GroupHeaderTextStyle} M Margin= n 0,0,0,20 n /> 
<ListView 工 temsSource= n {Binding FanSays} M Height= M 150 M / > 

</StackPanel> 

</Grid> 


And here’s the Pitcher class (it needs using System. Collections .ObjectModel; at the top): 

class Pitcher { 

public ObservableCollection<string> PitcherSays = new ObservableCollection<string>(); 
private int pitchNumber = 0; 


public Pitcher (Ball ball) { 

ball.BalllnPlay += ball BalllnPlay; 

} 一 f 

void ball—BalllnPlay(object sender, EventArgs e) { 

pitchNumber++; 
if (e is BallEventArgs) { 

BallEventArgs ballEventArgs = e as BallEventArgs; 
if ((ballEventArgs.Distance < 95) && (ballEventArgs.Trajectory < 60) ) 

CatchBall(); 

else 

CoverFirstBase(); 


Wlc you s 

BallkPlay cvcrrb V^dlev*. 

I 七 looks 扣 y low balls. 


private void CatchBall () { 

PitcherSays.Add( M Pitch # M + pitchNumber 

} 

private void CoverFirstBase () { 

PitcherSays.Add( M Pitch # M + pitchNumber 


I caught the ball"); 


工 covered first base") 


Ball 1: 


Ball 2: 


Trajectory: 

75 

Trajectory: 

午 0 

Distance: 

105 

Distance: 

90 


values we used 

^ ^ /ou,s 

Ball 3: ” ^ a liUl c 

午 O 


Trajectory: 

Distance: 
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introducing the events page 


frcwcric EvcwtHawdlcrs let you define your own event types 


Take a look at the event declaration in your Ball class: 
public event EventHandler BalllnPlay; 


Now open up any Windows Forms app and take a look at the Click event declaration from a 
button form, and most of the other controls you used in the first part of this book: 

public event EventHandler Click; 

Notice anything? They have different names, but they’re declared exactly the same way. And while 
that works just fine, someone looking at your class declaration doesn’t necessarily know that the 
Bal IE vent Handler will always pass it a BallEventArgs when the event is fired. Luckily, 
.NET gives us a great tool to communicate that information very easily: a generic EventHandler^ 
Change your ball’s BalllnPlay event handler so it looks like this: 


The 

"fco 

Evchtttahdlcv* has 
"to be a subclass 
of EvchtAv-gs. 


public event EventHandler<BallEventArgs> BalllnPlay; 


You’ll also need to change the OnBallInPlay method to replace EventHandler with 
EventHandler<BallEventArgs>. Now rebuild your code. You should see this error: 



Now that you changed the event declaration, your reference to it in the Ball class needs to be updated too: 

EventHandler<BallEventArgs> balllnPlay = BalllnPlay; 
if (balllnPlay != null) 
balllnPlay(this, e); 

C 4 * does implicit conversion when you leave out the hew keyword and type 

You used the IDE to automatically create this event handler method a few pages ago: 
ball•BalllnPlay += ball—BalllnPlay; 

When you use this syntax, G# does an implicit conversion and figures out the type for you. Try replacing that 
line in the Pitcher or Fan class with it: 

ball•BalllnPlay += new EventHandler<BallEventArgs>(ball—BalllnPlay); 

Your program still runs just fine because the IDE automatically generated code that used implicit conversion. That 
way, you didn’t have to modify the type when you changed the type of the event. 


716 Chapter 15 













events and delegates 


Windows Forms use many different cvcwts 

We’re going to switch gears and go back to desktop applications for the next two projects, 
because they give us a really good learning tool. That’s because every time you’ve created a 
button, double-clicked on it in the designer, and written code for a method like button 1_ 
Click (), you’ve been working with events. (Windows Store apps use events too.) 




Create a new Windows Forms Application project. Go to the Properties window for the 
form. Remember those icons at the top of the window? Click on the Events button (it’s the 
one with the lightning bolt icon) to bring up the events page in the Properties window: 


Vo\A SCC dll o-P -the 
events -fo\r a 
jus-t dli^k oy\ i*t dhd 
"then dli^k ov\ -this 

Bwts bu-t-feo^ \y\ the 
P\ropcv-tics w’mdow. 



em.Wind ows.Fo rms, Form 


□=： 


fhanaeUICues 






y/ill -f iv-c cvcv"Y someone 

c\\eMs oy\ -fov-rn by sclcdtrnj 

For J Ckk CWcy *rn 

■ — _ 

cvcK\*ts wmdow. 



LlientuzeChanged 
ContextMenu Strip Changed 

Clkk 

Occurs when the component is clicked, 


▲ 


V 


▼ 


Scroll doy/K\ *bo CU ar\d doublc- 
e\\ck oy\ word *to make 

^ |PE add a ^ 

iia^dilcv- -to youv- -fovm *Ha*t 
-Piv-cd cvcv"Y tiw'C you c.l»dk or> 

*rt. A^d \{!W add a l*mc -to Fovml 
Pcsi^cv- ts to V^ook {\\t everrb 
^a^dlc^r up -to -tV^c event 


❺ 


Double-click on the Click row in the events page. The IDE will automatically add an event 
handler method to your form called Forml—Click. Add this line of code to it: 

private void Forml_Click(object sender, EventArgs e) { 

MessageBox.Show("You just clicked on the form"); 


肴 



Visual Studio did more than just write a little method declaration for you, though. It also hooked 
the event handler up to the Form object’s Click event. Open up Forml.Designer.cs and use the 
Quick Find (Edit—^Find and Replace^Quick Find) feature in the IDE to search for the text 
Forml—Click in the current project. You’ll find this line of code: 

this.Click += new System.EventHandler(this.Forml_Click); 


Now run the program and make sure your code works! 


You’re not done yet—Hip tke page! 
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introducing the events page 


One event multiple handlers 

Here’s a really useful thing that you can do with events: you can chain them 
so that one event or delegate calls many methods, one after another. Let’s 
add a few buttons to your application to see how it works. 



Add these two methods to your form class: 


private void SaySomething(object sender, EventArgs e) { 

MessageBox.Show("Something"); 


private void SaySomethingElse(object sender, EventArgs e) { 

MessageBox.Show("Something else"); 



Now add two buttons to your form. Double-click on each button to add its event 
handler. Here’s the code for both event handlers: 

private void buttonl—Click(object sender, EventArgs e) { 

this.Click += new EventHandler(SaySomething); 


private void button2_Click(obj ect sender, EventArgs e) { 
this.Click += new EventHandler(SaySomethingElse); 



■Dumb Questi9ns- 

When I added a new 
event handler to the Pitcher 
object, why did the IDE make it 
throw an exception? 

A: It added code to throw 
a NotlmplementedException 
to remind you that you still 
need to implement code there. 
That’s a really useful exception, 
because you can use it as a 
placeholder just like the IDE did. 

For example, you’ll typically use 
it when you need to build the 
skeleton of a class but you don’t 
want to fill in all the code yet. 

That way, if your program throws 
that exception, you know it’s 
because you still need to finish 
the code, and not because your 
program is broken. 


Before you go on, take a minute and think about what those two buttons do. Each button hooks up a 
new event handler to the form’s Click event. In the first three steps, you used the IDE to add an 
event handler as usual to pop up a message box every time the form fired its Click event — it added code 
to Forml.Designer.cs that used the += operator to hook up its event handler. 


Now you added two buttons that use the exact same syntax to chain additional event handlers onto the 
same Click event. So before you go on, try to guess what will happen if you run the program, click 
the first button, then click the second button, and then click on the form. Gan you figure it out before you 
run the program? 


We’re using a Windows 
Forms application for 
this project to take 
advantage of the way 
Windows Forms use 
events. This will work 
with any event, but the 
button’s Click event 
makes it very easy to 
explore how this works. 



Event handlers always need to be ^hooked up.” 

If you drag a button onto your form and add a method 
called buttonl—Click () that has the right parameters 
but isn’t registered to listen to your button, the method 
won’t ever get called. Double-click on the button in the 
designer—the IDE will see the default event handler name is taken, so 
it’ll add an event handler for the button called buttonl Click 1 (). 


Watch it! 
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events and delegates 


Now run your program and do this: 

* Click the form — you’ll see a message box pop up that says, “You just clicked on the form. 


55 





You just clicked on the form 


OK 



少 st what you’d expert—the 

^o\r^s Clidk CVCht hdhdler 
pops up a message box. 




Now click button 1 and then click on the form again. You’ll see two message boxes 
pop up: “You just clicked on the form” and then “Something.” 


口彳 Forml 



button 1 


button2 




You just clicked on the form 


OK 



But cvev-y 
■time you didk 
a burbtoir^ i 七 
causes yc*t 
a^o*thcv- 
messaje box. 
■to fop up 七 he 
灼 ext *tirwc you 
didk OY\ 七 he 
*Po\rr»\, 


Click button2 twice and then click on the form again. You’ll see four message boxes: 
: You just clicked on the form,” “Something,” “Something else,” and “Something else.” 


W Forml 







button 1 





IbuttonZ 










So what happened? 

Every time you clicked one of the buttons, you chained another method — either Something () Y c csc 

or SomethingElse () — onto the form’s Click event. You can keep clicking the buttons, and ^ 

they’ll keep chaining the same methods onto the event. The event doesn’t care how many 1 hhdlevs 

methods are chained on, or even if the same method is in the chain more than once. It’ll just call 十 s Uidk cvcht. 

them all every time the event fires, one after another, in the order they were added. Tha*t vv\CBy\s you >won’*t see 

you dl'idk *tV>c 

buttons/ Voull Y\ttd bo dlidk 

or\ *tKc -fovm, bedduse 七 i 化 

button 七 he -fov-m^s 

bcK^viov* by rwodi-fyi^5 
Clidk e^evyi- 




lick event 


ob^° 






SaySomethingElse() 



SaySomethingElse() 


TilC Sdvv\C method 
be teamed oy\ 
{jo ar\ event i^ovc 
七扣 OY\Ct- 
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a day in the life of an app 


Windows Store apps use events for 
process lifetime management 

You’ve probably noticed one important difference between Windows Store apps and desktop 
applications: there’s no obvious way to close a Windows Store app. But think about it for a minute...why 
would you ever really need to close an app? You may need to switch out of it, but what if your computer 
has enough memory and extra GPU cycles to keep it alive for you in case you want to come back to 
it? When you switch away from an app, Windows suspends it, and while an app is suspended it stays 
in memory, with all of the objects and resources it needs kept alive. If Windows needs to free up that 
memory, it will terminate the app, unloading it and freeing up any resources it’s using. But as a user, 
do you really care if your app is suspended or terminated? In most cases, users actually don’t care — as 
long as when the app resumes, it returns to a state that makes sense to the user. When an app responds 
to Windows suspending and resuming it, that’s called process lifetime management. 


Every time 

Use the IPE to explore process lifetime management events Winctows 


Open up any Windows Store app and double-click on App.xaml.es in the Solution Explorer. 
Find the App constructor: 

public App( ) 

{ 

this . Initial!zeCemponentf ) ■ 
this . Suspending += OnSyspending; 

} 


You should recognize what’s going on here. App, which is a subclass of the Application 
class in the Windows . UI • Xaml namespace, has an event called Suspending, and it’s 


being hooked up in the constructor to an event handler called OnSuspending. Right-click 


on So spending and choose Go To Definition to open the 


metadata] 


tab 


with the members of the Application class, and jump to the Suspending event: 


suspends 
a Winctows 
Store app, 
tke app’s 
Suspending 
event is firect 
so tkat it can 


// save its state. 

// Summary : 

// Occurs when the application transitions to Suspended state from some other 

// state . 

public event Su spend ingE vent Handler Su spend ingj 


This event is fired any time the user switches away from your app. This means that the OnSuspending () method 
in App.xaml.es is called every time your app is suspended. And similarly, the OnLaunched () method m App.xaml.es is 
called every time your app is launched. 

Once your app is suspended, Windows can terminate the app at any time. So you should build your app to act like 

it’s going to be terminated every time it’s suspended by saving its current state. The OnLaunched () 
method can check its arguments to see if it’s starting again after a previous suspension. 
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events and delegates 


Add process lifetime managemeHt to Jimmy’s comics 

Let’s modify Jimmy’s comic book app to save and restore the current page. We’ll modify its 
Suspending event handler so it writes the name of the current query to a file in the app’s 
local folder when Jimmy switches away from the app. If Windows terminates the app, we’ll 
make sure to switch back to that page when it’s launched again. 



❶ Add a class to manage saving and loading the state. 

Add a class called SuspensionManager. It has a static property to keep 
track of the current query, and two static methods to read and write the name of 
the query to a file called _sessionState. txt in the app’s local folder. 


using Windows.Storage; 

class SuspensionManager { 

public static string CurrentQuery { get; set; } 

private const string filename = n _sessionState.txt"; 


static async public Task SaveAsync() { 

if (String • 工 sNullOrEmpty(CurrentQuery)) 

CurrentQuery = String.Empty; 

工 StorageFile storageFile = 

await ApplicationData.Current.LocalFolder.CreateFileAsync( 

filename, CreationCollisionOption.ReplaceExisting); 
await FilelO•WriteTextAsync(storageFile, CurrentQuery); 


static async public Task RestoreAsync() { 

工 StorageFile storageFile = 

await ApplicationData.Current.LocalFolder.GetFileAsync(filename); 
CurrentQuery = await FilelO.ReadTextAsync(storageFile); 



Make the main page update SuspensionManager when a query is loaded. 

The ListView in MainPage.xaml causes the app to navigate when an item is clicked, so 

add a line to its ItemClick event handler to set SuspensionManager 5 s static 
CurrentQuery property to the title of the query being loaded: 


private void ListView 一工 temClick(object sender, 工 temClickEventArgs 
ComicQuery query = e•Clickedltem as ComicQuery; 
if (query != null) { 

SuspensionManager.CurrentQuery = query.Title; ^ - 

if (query.Title == "All comics in the collection") 

this.Frame.Navigate(typeof(QueryDetailZoom ), query); 

else 

this.Frame.Navigate(typeof(QueryDetail ), query); 


e) { 


Evcv-y tirwc a 
is dicVtA, *tKc cvcr>*t 
iidv>dlev updates 
static Cuv-v-c^t^ucvy 
pv-ofcv*ty. 
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app interrupted 



Override the OnNavigatedFrom () method to clear the saved query- 

When the user clicks the back arrow to navigate away from a page, one of the things that it does 
is fire the NavigatedFrom event. Update the code-behind for both the Query Detail and 
QueryDetailZoom pages to override the OnNavigatedFrom () method, which is invoked 
right after the Page is unloaded. Go to Query Detail, xaml. cs and type the override 
keyword in the class, then use the IntelliSense window to create a method stub: 


餐 


override 


GnManipulationStarting[ManipulationStartingRoutedEventArgs e) 


OnNavig ated From (N avig ation EventArg s e) 


OnNavigatedTo[NavigationEventArgs e) 

OnNavigatingFromfNavigatingCancelEventArgs e) 
OnPointerCanceledfPointerRoutedEventArgs e) 
OnPoi nterC a ptu reLostfP o i nterRo uted EventArgs e) 
W* OnPointerEnteredfPointerRoutedEventArgs e) 
OnPoi nterBdted (P o i nterRo uted EventArgs e] 

OnPoi nterM oved(Poi nterRo uted EventArgs e) 


void Common,LayoutAwarePage.OnNavigatedFrom(NavigationEventArgs e) 
Invoked when this page will no longer be displayed in a Frame. 


When you choose OnNavigatedFrom () from the IntelliSense window, the IDE adds a stub 
method that calls the base class’s OnNavigatedFrom () method. Add a line to clear the 
query. Then make sure you do the same thing for QueryDetailZoom. xaml. cs. 


protected override void OnNavigatedFrom(NavigationEventArgs e) 

SuspensionManager.CurrentQuery = null; 

base.OnNavigatedFrom(e); 


1/Vh ⑶七 he 6^ucv-yDctail ar\d ^ucv-yDctai l^oom 

-five theiv- 0^/s/avigaicdFv-om events -to 
badk -to the pay, this will dlcav 
七 he Cuvre 灼七公 uev~y pv-opev-ty. 



Modfiy the Suspending event handler to save the state. 


Open App.xaml.es and find the On Suspending () event handler method that was hooked up to 
the Suspending event. It has a comment that starts with TO DO: 


private void OnSuspending( object senderj SuspendingEventAngs e) 

{ 

var deferral 二 e. SuspendIngOperation.GetDeferral{) ; 

//TODO: Save application state and stop any background activity 
deferral.Complete()j 




Sor^c o-P the 
IDE’s tcrwpla'tcs 
ih^ludc these 
i{ T0V0 ，f lihes -to 
"tell you whcv-c 
its sa^e io add 
toAt- 



Replace the TODO line with a call to SaveAsync () . Make sure you add async to the 
beginning of the declaration so you can use the await keyword to make an asynchronous call: 
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async private void OnSuspending(object sender, SuspendingEventArgs 


var deferral = e.SuspendingOperation.GetDeferral (); 

await SuspensionManager.SaveAsync(>; 

deferral.Complete(); 
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events and delegates 



Update the OnLaunched method to restore the state. 

All of the changes so far cause the app to keep the SuspensionManager’s static CurrentQuery property 
up to date. Now all that’s left is to update the Launched event handler in App.xaml.es to restore the state. 


You 

七 iVis *to use 
ihc av/art 

opevaiov*. 


async protected override void OnLaunched(LaunchActivatedEventArgs args) { 

SettingsPane.GetForCurrentView().CommandsRequested += OnCommandsRequested; 

Frame rootFrame = Window.Current.Content as Frame; 

// Do not repeat app initialization when the Window already has content, 

// just ensure that the window is active 
if (rootFrame == null) 

{ 

// Create a Frame to act as the navigation context and navigate to the first page 
rootFrame = new Frame(); 


if (args.PreviousExecutionState == ApplicationExecutionState.Terminated) { 

await SuspensionManager.RestoreAsync () ; ^ ^ 

load 七 he s-ta-tc -Pvorw a previously sus^e^ded 

// Place the frame in the current Window application. Replace it v/ith a dal I h> the 

Window. Current. Content = rootFrame; Rcs-fcovcAsy^tO mc-thod. 


if (rootFrame.Content == null) { 

// When the navigation stack isn't restored navigate to the first page, 

// configuring the new page by passing required information as a navigation 
// parameter 

if (!rootFrame.Navigate(typeof(MainPage ), args.Arguments)) { 

throw new Exception ("Failed to create initial page ，，）； 


Add *tVis todc 

^v-cv'iously saved 
state *to 

|'is*t 0 *(* <\UCV"lCS. 
|*f rt w'3't^^cs 3 
<\uCV*Y> 
syy ^av'i^atcs 
•bo *tKat 

dc*ta'»l pay. 


if (!String.IsNullOrEmpty(SuspensionManager.CurrentQuery)) { 

var currentQuerySequence = 

from query in new ComicQueryManager().AvailableQueries 


where query.Title 
select query; 




SuspensionManager.CurrentQuery 


Take a dose look 
ai -this 

^uevy. Do you see 


how i-t v/o\rks? 


if (currentQuerySequence.Count() == 1) { 

ComicQuery query = currentQuerySequence.First(); 
if (query != null) { 

if (query.Title == "All comics in the collection") 

rootFrame.Navigate(typeof(QueryDetailZoom), query); 

else 

rootFrame.Navigate(typeof(QueryDetail), query); 


平 


V 


// Ensure the current window is active 
Window.Current.Activate(); 




You can use the Suspend drop-down to test the app. It’s in 
the Debug Location toolbar, which only shows up when the 
app is running in the debugger (if you don’t see it, select 
it from View^Toolbars). Click Suspend and shutdown to 
terminate the app and call its OnSuspending event. 


Suspend ^ 


Suspend 

Resume 

Suspend and shutdown 




you are here 
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bubble bubble, toil and trouble 

XAML controls use routed events 

Flip back a few pages and have a closer look at the IntelliSense window that popped up when you typed 
override into the IDE. Two of the names of the event argument types are a little different than the others. 
The Double Tapped event’s second argument has the type DoubleTappedRoutedEventArgs, and 
the GotFocus event’s is a RoutedEventArgs. The reason is that the DoubleTapped and GotFocus 
events are routed events. These are like normal events, except for one difference: when a control object 
responds to a routed event, first it fires off the event handler method as usual. Then it does something else: 
if the event hasn’t been handled, it sends the routed event up to its container. The container fires the 
event, and then if it isn’t handled, it sends the routed event up to its container. The event keeps bubbling 
up until it’s either handled or it hits the root, or the container at the very top. Here’s a typical routed event 
handler method signature. 

private void EventHandler(object sender r RoutedEventArgs e) 

The RoutedEventArgs object has a property called Handled that the event handler can use to indicate 
that it’s handled the event. Setting this property to true stops the event from bubbling up. 

In both routed and standard events, the sender parameter always contains a reference to the object that 
called the event handler. So if an event is bubbled up from a control to a container like a Grid, then when 
the Grid calls its event handler, sender will be a reference to the Grid control. But what if you want 
to find out which control fired the original event? No problem. The RoutedEventArgs object has a 
property called OriginalSource that contains a reference to the control that initially fired the event. If 
Original Source and sender point to the same object, then the control that called the event handler is 
the same control that originated the event and started it bubbling up. 


IsHitTcstYisiblc determines if aw element is "visible" 
to the pointer or mouse 

Typically, any element on the page can be “hit” by the pointer or mouse — as 
long as it meets certain criteria. It needs to be visible (which you can change 
with the Visibility property), it has to have a Background or Fill 
property that’s not null (but can be Transparent), it must be enabled (with 
the IsEnabled property), and it has to have a height and width greater 
than zero. If all of these things are true, then the IsHitTestVisible 
property will return True, and that will cause it to respond to pointer or 
mouse events. 

This property is especially useful if you want to make your events “invisible” 
to the mouse. If you set IsHitTestVisible to False, then any pointer 
taps or mouse clicks will pass right through the control. If there’s another 
control below it, that control will get the event instead. 

You can see a list of input events that are routed events here: 
http://msdn.microsoft.com/en-us/library/windows/apps/Hh758286.aspx 


Tke structure ol 
controls tkat contain 
otker controls tkat 
in turn contain yet 
more controls is called 
an object tree, and 
routed events tuttle 
up tke tree from tke 
ckilct to parent until 
tkey kit tke root 
element at tke top. 
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events and delegates 


Create aw app to explore routed events 


Here’s a Windows Store app that you can use to experiment with routed events. It’s got a 
StackPanel that contains a Border, which contains a Grid, and inside that grid are an Ellipse 
and a Rectangle. Have a look at the screenshot. See how the Rectangle is on top of the Ellipse? 
If you put two controls into the same cell, they’ll stack on top of each other. But both of those 
controls have the same parent: the Grid, whose parent 
is the Border, and the Border’s parent is the StackPanel. 

Routed events from the Rectangle or Ellipse bubble up 
through the parents to the root of the object tree. 


么 〆’ Alakc su\rc you v-cpladc 


AlaihRagc xarwl wi-th a 

的 cw Basi£. 


Border sets handled 


Grid sets handled 


This is a Toggle Switch control, 
which you can use to toggle a value on 
and off. The header text is set with the 
Header property, and you can set and 
get its value using the Is On property. 


Ilipse sets 


Rectangle sets handled 




handled 


Update Rectangle IsHitTestVisible 


New IsHitTestVisible value 


Routed cvchts 
bubble up "the 


<Grid Grid.Row= M l M Margin= M 120 A 0 M > 

<Grid.ColumnDefinitions> 

<ColumnDefinition Width= M Auto M /> 

<ColumnDefinition/> 

</Grid.ColumnDefinitions> 

<StackPanel x:Name= M panel M PointerPressed= n StackPanel 一 PointerPressed”> 

〈Border BorderThickness= M 10 M BorderBrush= M Blue M Width= M 155 M x : Name= M border" 

Margin= M 20 M PointerPressed="Border_PointerPressed M > 

<Grid x:Name= M grid M PointerPressed= M Grid_PointerPressed M > 

〈Ellipse Fill= M Red M Width= M 100 M Height= M 100 M 

PointerPressed= n Ellipse 一 PointerPressed”/> 

〈Rectangle Fill= M Gray M Width= M 50 M Height= M 50 M 

PointerPressed= n Rectangle 一 PointerPressed” x:Name= M grayRectangle M /> 

</Grid> 

</Border> 

<ListBox BorderThickness= M l M Width= M 300 M Height= M 250 M x : Name= M output M Margin= M 0,0,20,0 M /> 
</StackPanel> 

<StackPanel Grid.Column= M l M > 

<ToggleSwitch Header= M Border sets handled" x : Name= M borderSetsHandled M / > 

<ToggleSwitch Header= M Grid sets handled" x : Name= M gridSetsHandled M /> 

<ToggleSwitch Header= M Ellipse sets handled" x : Name= M ellipseSetsHandled M /> 

<ToggleSwitch Header= M Rectangle sets handled" x : Name= M rectangleSetsHandled M /> 

<Button Content^"Update Rectangle IsHitTestVisible” 

Click= M UpdateHitTestButton M Margin= M 0,20, 20, 0 M /> 

<ToggleSwitch 工 sOn =, ’True n Header= M New IsHitTestVisible value" 

x:Name="newHitTestVisibleValue" /> r | s 〜 defaults *to False. This swi*tdh has i*t 
〈 /StackPanel 〉 sc*t *to TiruC bedduse dor>*tvols dlwdVs have 

</Gnd> |sHi*tTcs*t\/isiblc sc*t *to *tvuc by dc+ault 


_ 


Flip the pa^e to ftnish the afp 


► you are here ► 
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climbing the object tree 


N55D THIS Osse^vas^eCo^ecTiON JO DISPLAY OUTPUT IN TH5 LISTBd 


Make a field called outputltems and set the ListBox . 工 temsSource property in the page constructor. And don’t 
forget to add the using System. Collections . ObjectModel; statement for ObservableCollection<T>. 

public sealed partial class MainPage : RoutedEvents.Common.LayoutAwarePage { _ 


ObservableCollection<string> outputltems = new ObservableCollection<string>(); 

public MainPage() { 

this.InitializeComponent(); 

output.ItemsSource = outputltems; 


Here’s the code-behind. Each control’s Pointer Pressed event handler clears the output if it’s the original source, 
then it adds a string to the output. If its “handled” toggle switch is on, it uses e . Handled to handle the event. 

private void Ellipse_PointerPressed(obj ect sender, PointerRoutedEventArgs e) { 


if (sender == e.OriginalSource) outputltems•Clear(); 
outputltems.Add( n The ellipse was pressed"); 
if (ellipseSetsHandled • 工 sOn) e.Handled = true; 


Some routed cvcht hahdlcvs will ^ 。丄仏 " 





private void Rectangle_PointerPressed(obj ect sender, PointerRoutedEventArgs e) { 
if (sender == e.OriginalSource) outputltems•Clear(); 
outputltems•Add( n The rectangle was pressed"); 
if (rectangleSetsHandled • 工 sOn) e.Handled = true; 

} 

private void Grid_PointerPressed(object sender, PointerRoutedEventArgs e) { 
if (sender == e.OriginalSource) outputltems•Clear(); 
outputltems•Add("The grid was pressed"); 
if (gridSetsHandled • 工 sOn) e.Handled = true; 

} 

private void Border_PointerPressed(object sender, PointerRoutedEventArgs e) { 
if (sender == e.OriginalSource) outputltems•Clear(); 
outputltems•Add( n The border was pressed"); 
if (borderSetsHandled • 工 sOn) e.Handled = true; 

} 

private void StackPanel_PointerPressed(object sender, PointerRoutedEventArgs e) { 
if (sender == e.OriginalSource) outputltems•Clear(); 
outputltems•Add( n The panel was pressed"); 

} 

private void UpdateHitTestButton(object sender, RoutedEventArgs e) { 
grayRectangle • 工 sHitTestVisible = newHitTestVisibleValue • 工 sOn; 
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W5125，S TH5 O&JBCT 今 12APH Y^>U12 MAIN PA^B. 

The Main Page class is at the root of the object tree. The default 
MainPage.xaml is an instance of Page, but when you use the Basic Page 
template it extends a subclass of Page called LayoutAwarePage. 


This is the grid that was added to the main 
page as part of the Basic Page template. 


Here’s the StackPanel that contains the 
I 晏 Border, Grid, Ellipse, and Rectangle. 




This grid can receive routed 
Pointer Pressed events, 
but it won’t raise them. Its 
工 sHitTestVisible property 
defaults to False because it doesn’t 
have a Background or Fill 
property. If you update the XAML 
to add a Background property, 
its IsHitTestVisible property 
will default to true — even if you 
set that property to Transparent. 
That will cause it to respond to 
pointer presses. 



RecV 


Flip the pa^e to use your new ^pto explore routed events 




you are here 
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the bubbles go straight to your head 


I2UN TH5 APP AND CLICK OE TAP TH5 
I266TAN^L5. 


You should see the output in the screenshot to the right. 




You can see exactly what’s going on by putting a breakpoint on the first line of 
Rectangle—PointerPressed () ， the Rectangle control’s Pointer Pressed 
event handler: 

private void Rectangle_PointerPressed( object sender, PointerRoutedEventArgs e) 


.OriginalSource) 


outputItems.Clear() 
outputltems .Add("The rectangle was pressed"); 
if (rectangleSetsHandled.IsOn) e.Handled = true; 



The rectangle was pressed 


The grid was pressed 


The border was pressed 


The panel was pressed 


Click the gray rectangle again — this time the breakpoint should fire. Use Step 
Over (F10) to step through the code line by line. First you’ll see the if block 
execute to clear the outputltems ObservableCollection that’s bound to 
the ListBox. This happens because sender and e . OriginalSource reference 

the same Rectangle control, which is only true inside the event handler method for the control that originated the 
event (in this case, the control that you clicked or tapped), so sender == e . OriginalSource is true. 


When you get to the end of the method, keep stepping through the program. The event will bubble up 
through the object tree, first running the Rectangle’s event handler, then the Grid’s event handler, then the Border’s, 
and then the Panel’s, and finally it runs an event handler method that’s part of LayoutAwarePage — this is 
outside of your code and not part of the routed event, so it will always run. Since none of those controls are the 
original source for the event, none of their senders will be the same as e . OriginalSource, so none of them 
clear the output. 


TU12N IsHrrTesTVisiaue PE5SS TH5 xV UPDAT5 /, 
BUTTON, AND THEN CLICK ^ TAP TH5 1266TANd3rL5. 


Update Rectangle IsHitTestVisible 



New IsHitTestVisible value 


M - You 

Wait a minute! You pressed the 

Rectangle, but the Ellipse control’s Pointer Pressed event handler 
fired. What’s going on? 

When you pressed the button, its Click event handler updated 
the Rectangle control’s IsHitTestVisible property to false, 
which made it “invisible” to pointer presses, clicks, and other pointer 
events. So when you tapped the rectangle, your tap passed right 
through it to the topmost control underneath it on the page that has 
IsHitTestVisible set to true and has a Background property 
that’s set to a color or Transparent. In this case, it finds the Ellipse 
control and fires its Pointer Pressed event. 
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TH5 W&12ID 

SETS HANDL5D /, SWITCH 
Obi AND CLICK OE TAP 
TH5 ^EAY I256TAN^L5. 


Border sets handled 



Grid sets handled 


Ellipse sets handled 


The rectangle was pressed 


The grid was pressed 


Rectangle sets handled 


You should see this output. - ► 

So why did only two lines get 
added to the output ListBox? 

Step through the code again 
to see what’s going on. This time, 
gridSetsHandled.IsOn 
was true because you toggled the 
gridSetsHandled to On, so 
the last line in the Grid’s event 
handler set e. IsHandled to 
true. As soon as a routed event 
handler method does that, the 
event stops bubbling up. As soon 
as the Grid’s event handler completes 
the app sees that the event has 
been handled, so it doesn’t call the Border or Panel’s event handler method, and instead skips to the event 
handler method in Layout Aware Page that’s outside of the code you added. 




New IsHitTestVisible value 



USB TH5 OPPIO 5XP512IM5NT WITH E^UTBD 5V5NTS. 

Here are a few things to try: 

* Click on the gray rectangle and the red ellipse and watch the output 
to see how the events bubble up. 

* Turn on each of the toggle switches, starting at the top, to cause the 
event handlers to set e . Handled to true. Watch the events stop 
bubbling when they’re handled. 

* Set breakpoints and debug through all of the event handler methods. 

* Try setting a breakpoint in the Ellipse’s event handler method, then 
turn the gray rectangle’s 工 sHitTestVisible property on and off 
by toggling the bottom switch and pressing the button. Step through 
the code for the rectangle when I sHitTestVisible is set to 
false. 

* Stop the program and add a Background property to the Grid to 
make it visible to pointer hits. 


A routed event 
first iires tke 
event kandler lor 
tke control tkat 
originated tke event, 
and tken l>ul>l>les up 
tkrougfli tke control 
kierarcky until it 
kits tke top—or an 
event kandler sets 
e.Hanctlect to true. 


you are here ► 
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givers and receivers 


Cowwectiwg event senders with event listeners 


One of the trickiest things about events is that the sender of the event has 
to know what kind of event to send — including the arguments to pass to the 
event. And the listener of the event has to know about the return type and the 
arguments its handler methods must use. 

But — and here’s the tricky part — you can’t tie the sender and receiver together. 
You want the sender to send the event and not worry about who receives it. And the 
receiver cares about the event, not the object that raised the event. So both sender 
and receiver focus on the event, not each other. 


Ball weds — 
about Balll^, 
betake \i ^ceds to 
从 at 




BalllnPlay event 


◄- 



〆 Chi ^dl c ^ 


c 

Ball does HOT *to v/orry 
about Prt^ev*. It docs^t 
y/V^a-t *b/? e J … 0 也 w 七 " 七 : 




"My people will get in touch with your people" 


You know what this code does: 

Ball currentBall; 

It creates a reference variable that can point to any Ball object. It’s 
not tied to a single Ball. Instead, it can point to any ball object — or it 
can be null, and not point to anything at all. 

An event needs a similar kind of reference — except instead of pointing 
to an object, it needs one that points to a method. Every event needs 
to keep track of a list of methods that are subscribed to it. You’ve already 
seen that they can be in other classes, and they can even be private. So 
how does it keep track of all of the event handler methods that it needs 
to call? It uses something called a delegate. 


del-e-gate ， noun. 

a person sent or 
authorized to represent 
others. The president sent a 
delegate to the summit. 
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events and delegates 


A delegate STANPS IN for aw actual method 

One of the most useful aspects of events is that when an event fires, it has no idea 
whose event handler methods it’s calling. Anyone who happens to subscribe to an event 
gets his event handler called. So how does the event manage that? 

It uses a G# type called a delegate. A delegate is a special kind of reference type that 
lets you refer to a method inside a class. . .and delegates are the basis for events. 

You’ve actually already been using delegates throughout this chapter! When you created 
the BalllnPlay event, you used EventHandler. Well, an EventHandler is 
just a delegate. If you right-click on EventHandler in the IDE and select Go To 
Definition, this is what you’ll see (try it yourself): 


you dveate a 
delegate, all you v\ttd 
{o do is spcdi-fy 
si^r>a*tuVC c^f methods 
七 (a 七 I 七 fom 七七 o. 



So {\\\s delegate ^ be 
used *to ar>y 

mc*tKod i\\ai takes 
obje&t dr\d ar> 
av\d lids y\o vc*tuv-y> value. 


public delegate void EventHandler(object sender, EventArgs e 


TVis sfcti-fics i\\t value oi delete s 欠 

mea 於 s a 於 Evc^-tHa^dlcv o^ly 

fomt *to methods W\i\\ void values. 


deMe is 


A delegate adds a new type to your project 


命 



o 

IS 


I 


When you add a delegate to your project, you’re adding a delegate type. And when you use it to create a field or variable, 
you’re creating an instance of that delegate type. So create a new Console Application project. Then add a new 
class file to the project called ConvertsIntToString.cs. But instead of putting a class inside it, add a single line: 


delegate string ConvertsIntToString(int i); 


is a delegate *tyfc 七 ha 七 

you vc added b> youv- pvojcdt No>w you 

Next, add a method called HiThere () to your Program class: use 'rt "to dctlavc variables This is \us 七 like 

private static string HiThere (int i) s Sl 9 h ^ uv>c how Vou tBv\ use 3 tlass ov 匕 C as a 

{ CS 。崎脱 殊， . 七 y 〆 。dtUt variables. 

return "Hi there! #" + (i * 100); 


Finally, fill in the Main () method: 

static void Main(string[] args) 


someAlcthod is di vd\ridb!c whose type is 
CohVC\rts|h"t7oS"t\rihg. |-t ； s 3 |o*t like B 
vav-iablc, except instead o( a label oy\ 

〆 objd 伽 the heap youVc puUmg a label oh a me 七 hod. 


ConvertsIntToString someMethod = new ConvertsIntToString(HiThere); 
string message = someMethod (5); 以 so ^ Mc ^od >st l.kc ^ 

今 Lakle. ^ you tall .-t l.kc a ^ talls 

^ateve^ ^od .I V^wto 七 to. 


Console.WriteLine(message); 
Console.ReadKey(); 


The someMethod variable is pointing to the HiThere () method. When your program calls someMethod (5), it calls 
HiThere () and passes it the argument 5, which causes it to return the string value “Hi there! #5 00” 一 exactly as if it 
were called directly. Take a minute and step through the program in the debugger to see exactly what’s going on. 


you are here ► 
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exploring delegates 


delegates m action 

There’s nothing mysterious about delegates — in fact, they 
don’t take much code at all to use. Let’s use them to help a 
restaurant owner sort out his top chef’s secret ingredients. 



% 


o 

Pclc-tc tiic dass 

dcdlav-a*tio^ -Pv-om 
•the y\C^i dlass -file 
v-cpladc it v/i*th 
■this Imc ok CoAt- 


Here's another 
program where 
we're using a 
Windows Forms 
app. This time 
it's because 
MessageBox. 
Show () blocks, 
which makes it 
easy to see what's 
going on. 


Create a new Windows Forms Application project and add a delegate. 

Delegates usually appear outside of any other classes, so add a new class file to your project and 
call it GetSecretIngredient.es. It will have exactly one line of code in it: 

delegate string GetSecretlngredient(int amount); 

(Make sure you delete the class declaration entirely.) This delegate can be used to create a variable 
that can point to any method that takes one int parameter and returns a string. 


❺ 


Add a class for the first chef, Suzanne. 

Suzanne.es will hold a class that keeps track of the first chef’s secret ingredient. It has a 
private method called SuzannesSecretlngredient () with a signature that matches 
GetSecretlngredient. But it also has a read-only property — and check out that property’s 
type. It returns a GetSecretlngredient. So other objects can use that property to get a 
reference to her SuzannesIngredientList ( ) method — the property can return a delegate 
reference to it, even though it’s private. 

class Suzanne { 

scdv-c*t public GetSecretlngredient MySecretlngredientMethod { 
method get { 

•takes return new GetSecretlngredient (SuzannesSecretlngredient) 

called amount ^v\A } 

a } 

that desdv-ibes hcv private string SuzannesSecretlngredient (int amount) { 

^^ - ^ return amount. ToString () + " ounces of cloves"; 

} 


o Then add a class for the second chef, Amy. 

Amy’s method works a lot like Suzanne’s: 


vc*tuvv>s a *ms*tay>dc o( 

广 delegate 七1^七 s 

b> hcv- sttrti me 七 hod. 


s scdv-ct 

’myedieyrt rwethod 
also takes 扣 m 七 

乙 dlled drnourrt dr\d 

\rctu\r^s 3 s-tv-mg, 
but i 七 v-ctu\r^s a 
di-P-Pcv-c^-t s-tv-'mg 
-Pv-om 


class Amy { 

public GetSecretlngredient AmysSecretlngredientMethod { 
get { 

return new GetSecretlngredient(AmysSecretlngredient) 


private string AmysSecretlngredient(int amount) { 
if (amount < 10) 

return amount.ToString() 

+ " cans of sardines -- you need more! 

else 

return amount. ToString () + ’▼ cans of sardines"; 


732 Chapter 15 







events and delegates 



Build this form. - 

Here’s the code for the form: 

GetSecretlngredient ingredientMethod = null; 
Suzanne suzanne = new Suzanne(); 

Amy amy = new Amy(); 



a ? Secret Ingredients 


Get the ingredient 


Get Suzannes delegate 


Get Amy's delegate 


private void uselngredient 一 Click (object sender, EventArgs e) { 
if (ingredientMethod != null) 

MessageBox•Show( n 工 ’11 add " + ingredientMethod((int) amount .Value)); 
else ^ 

MessageBox • Show ( n 工 don't have a secret ingredient !，'）； '' 

} su 代 you\r /VumcHdUpPoy/h 

^Oh-tirol is hamcd imouhF. 

private void getSuzanne_Click (object sender, EventArgs e) { 

ingredientMethod = new GetSecretlngredient(suzanne.MySecretlngredientMethod); 


private void getAmy_Click (object sender, EventArgs e) { 

ingredientMethod = new GetSecretlngredient(amy•AmysSecretlngredientMethod); 


❺ Use the debugger to explore how delegates work. 

You’ve got a great tool — the IDE’s debugger — that can really help you get a handle on how delegates work. 
Do the following steps (remember, the output will be printed to the IDE’s Output window): 


* Start by running your program. First click the “Get the ingredient” button — it should write a line to 
the console that says，“I don’t have a secret ingredient!’’ 

* Click the “Get Suzanne’s delegate” button — that takes the form’s ingredientMethod field 
(which is a GetSecretlngredient delegate) — and sets it equal to whatever Suzanne’s 
GetSecretlngredient property returns. That property returns a new instance of the 
GetSecretlngredient type that’s pointing to the SuzannesSecretlngredient () method. 



* Click the “Get the ingredient” button again. Now that the form’s ingredientMethod field 
is pointing to SuzannesSecretlngredient (), it calls that, passing it the value in the 
numericUpDown control (make sure it’s named amount) and writing its output to the console. 


* Click the “Get Amy’s delegate” button. It uses the Amy. GetSecretlngredient property to set the 
form’s ingredientMethod field to point to the Amys Secret Ingredient () method. 


* Click the “Get the ingredient” button one more time. Now it calls Amy’s method. 



Now use the debugger to see exactly what’s going on. Place a breakpoint on the first line of each of 
the three methods in the form. Then restart the program (which resets the ingredientMethod 
so that it’s equal to null), and start over with the above five steps. Use the Step Into (FI 1) feature 
of the debugger to step through every line of code. Watch what happens when you click “Get the 
ingredient.’’ It steps right into the Suzanne and Amy classes, depending on which method the 
ingredientMethod field is pointing to. 
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some events are too public 


Paa] Puzzjc 



Your job is to take snippets from the pool 
and place them into the blank lines in the 
code. You can use the same snippet more 
than once, and you won’t need to use all 
the snippets. Your goal is to complete the 
code for a form that writes this output to 
the console when its buttonl button is 
clicked. 

Output 

Fingers is coming to get you! 


public Forml() { 

工 nitializeComponent(); 

this ._ += new EventHandler (Minivan); 

this ._ += new EventHandler (_) 

} 

void Towtruck(obj ect sender, EventArgs e) { 

Console.Write("is coming M ); 

} 

void Motorcycle(object sender, EventArgs e) { 

buttonl._ += new EventHandler (_ 

} 

void Bicycle(object sender, EventArgs e) { 

Console.WriteLine("to get you ! n )； 

} 

void _(object sender, EventArgs e) { 

buttonl._ += new EventHandler (Dumptruck); 

buttonl._ += new EventHandler (_ 


void 


(object sender, EventArgs e) 


Console.Write("Fingers "); 


Note: Each thing from 
the pool can be used 
more than once. 
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events and delegates 


Aw object caw subscribe to aw event... 


Suppose we add a new class to our simulator, a Bat class, and that class adds a 
HitTheBall event into the mix. Here’s how it works: if the simulator detects that the 
player hit the ball, it calls the Bat object’s OnHitTheBall () method, which raises a 
HitTheBall event. 

So now we can add a bat—HitTheBall () method to the Ball class that subscribes to 
the Bat object’s HitTheBall event. Then, when the ball gets hit, its own event handler 
calls its OnBallInPlay () method to raise its own event, BalllnPlay, and the chain 
reaction begins. Fielders field, fans scream, umpires yell.. .we’ve got a ball game. 


TV^c s\mula-tov- 

七 V^c ba 七 toMtd ^ ballj 

so \i *tV\c ba*t object s 

祕七 TkBalK) me 七 W. 

2 


Ball subs^vibed *fco "the 
HitTheBall ewt. 


Wow its cvch-t hdhdlev- Uh 
iKvfo\rrn^tioh dbou~t 
how ha\rd the sy/ih^ ^s, 

私 3u\re out the distah^c 
t\rajc^-to\ry, a^d v-aise a 
BalllhPlay cvc^t. 




°^jec\ 


HitTheBall event 


...but that's wot always a good thing! 

There’s only ever going to be one ball in play at any time. But if the Bat 
object uses an event to announce to the ball that it’s been hit, then any 
Ball object can subscribe to it. And that means we’ve set ourselves up for 
a nasty little bug — what happens if a programmer accidentally adds three 
more Ball objects? Then the batter will swing, hit, and four different 
balls will fly out into the field! 




uv^ oV^I These kails Y/cvc 

su ?? oscd be V^cld m rtsfx^t 

• m cast v/as 

ou-t ?avk. 

从 a 七栋 c ? • 丨 UV^r 铷 / 劝 all jp'r 
^ out Wd! 

4 / 



°A/ecir 


^Qll ob〆 
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callbacks to the rescue 


Use a callback to control who's listening 


Our system of events only works if we’ve got one Ball and one Bat. If you’ve got several 
Ball objects, and they all subscribe to the public event HitTheBall, then they’ll all go 
flying when the event is raised. But that doesn’t make any sense.. .it’s really only one Ball 
object that got hit. We need to let the one ball that’s being pitched hook itself up to the bat, 
but we need to do it in a way that doesn’t allow any other balls to hook themselves up. 

That’s where a callback comes in handy. It’s a technique that you can use with delegates. 
Instead of exposing an event that anyone can subscribe to, an object uses a method (often a 
constructor) that takes a delegate as an argument and holds onto that delegate in a private 
field. We’ll use a callback to make sure that the Bat notifies exactly one Ball: 



The Bat will keep its delegate field private. 

The easiest way to keep the wrong Ball objects from chaining themselves onto the Bat’s 
delegate is for the bat to make it private. That way, it has control over which Ball object’s 
method gets called. 



The Bat's constructor takes a delegate that points to a method in the ball. 

When the ball is in play, it creates the new instance of the bat, and it passes the Bat object a 
pointer to its OnBall InPlay () method. This is called a callback method because the 
Bat is using it to call back to the object that instantiated it. 

The Ball obje^i passes a delegate 
-fco i-b owr> O^BalllhPlayO 

rweihod -to -the do^s-tv-ud-tov. 

The ba-t saves tha-t delegate i-b 
—aie hi-tBallCallbadk -field. 

°^jec\ 



o When the bat hits the ball, it calls the callback method. 

But since the bat kept its delegate private, it can be 100% sure that no other ball has been hit. 
That solves the problem! 



°^jec\ 


The othc\r balls 匕如’七 
亡 haih themselves oy\{jo 

the delegate bemuse 
it's a p\riva-tc -field ih 

the Ba-t 
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events and delegates 


The Case of the Golden Crustacean 

Henry “Flatfoot” Hodgkins is a TreasureHunter. He’s hot on the trail of one of the most 
prized possessions in the rare and unusual aquatic-themed jewelry markets: a jade-encrusted 
translucent gold crab. But so are lots of other TreasureHunters. They all got a reference to 
the same crab in their constructor, but Henry wants to claim the prize first. 

In a stolen set of class diagrams, Henry discovers that the GoldenCrab class raises a 
RunForCover event every time anyone gets close to it. Even better, the event includes 
NewLocationArgs, which detail where the crab is moving to. But none of the other 
treasure hunters know about the event, so Henry figures he can cash in. 

Henry adds code to his constructor to register his treasure—RunForCover () 
method as an event handler for the RunForCover event on the crab reference he’s got. 
Then, he sends a lowly underling after the crab, knowing it will run away, hide, and raise 
the RunForCover event — giving Henry’s treasure_RunForCover ( ) method all the 
information he needs. 

Everything goes according to plan, until Henry gets the new location and rushes to grab the 
crab. He’s stunned to see three other TreasureHunters already there, fighting over the crab. 

Hovo did the other treasure hunters beat Henry to the crab? 

- ► on page 741. 



TV^c to^shcuW 
Wms *bwo eve 灼七 
ha 灼 dlevs ov\*to 

七 load cvev^s. 

丁 ㈣ y 七 
as SOOY\ 

as {\\t -fovw 

loaded- 



l/Vhch the button 
is dideed, it calls 
the cvcKrt 
ha^dlcirs -that avc 

匕 hamed "to it 


public Forml() { 

工 nitializeComponent(); 

this. Load += new EventHandler(Minivan); 
this . Load += new EventHandler (Motorcycle); 

} 

void Towtruck(object sender, EventArgs e) { 
Console.Write("is coming "); 


void Motorcycle(object sender, EventArgs e) 
buttonl. Click += new EventHandler( Bicycle) 

void Bicycle(object sender, EventArgs e) { 

Console.WriteLine("to get you !")； 


Paa] Puzzjc 



3 two Load cv Ch -t hahdlm 
Jook up tycc separate 
hahdlc^s -to the UWs 

CJi 乙 k CVCh*t hdhdleV'. 


void Minivan (object sender, EventArgs e) { 

buttonl. Click += new EventHandler(Dumptruck) 
buttonl. Click += new EventHandler (Towtruck); 

} 

void Dumptruck (obj ect sender, EventArgs e) { 
Console.Write("Fingers "); 




Rcrwcrwbcv-, a lVi^Fo\rrws app 七 he 
ConsoleW\riicLir)cO wv-iics to 

the Ou'tpu't v/mdow m "the IDE. 
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leave a message; i’ll call you back 


A callback is just a way to use delegates 

A callback is a different way of using a delegate. It’s not a new 
keyword or operator. It just describes a pattern — a way that you use 
delegates with your classes so that one object can tell another object, 
“Notify me when this happens — if that’s OK with you!” 



Define another delegate in your baseball project. 

Since the Bat will have a private delegate field that points to the Ball object’s OnBallInPlay() 
method, we’ll need a delegate that matches its signature: 


delegate void BatCallback(BallEventArgs e) 

do〆 七 always "to live m "theiv oym -Piles. 

TVy puttmj this ov\c \y\ the -Pile as Bat /1/Iakc suve 
its msidc the but outside the Bat dass. 


The Ba-t objed-t's dallbadk will po'mt -to a Ball 

objects O^BallJ^playO method ； so -the ddllbadk’s 
々 / delegate v\ttds io maidh 七 he o*f 

咖 I ， -•« ' * • - n •• 


Or>Ball|^PIayO—so \i y\ttds io -take a BallEvc^iA^js 
p3V3nr»ctcv* h^vc 3 void vdluc- 




Add the Bat class to the project. 

The Bat class is simple. It’s got a HitTheBall () method that the simulator will call every time 
a ball is hit. That HitTheBall () method uses the hitBa 11 Callback delegate to call the 
ball’s OnBall InPlay () method (or whatever method is passed into its constructor). 


class Bat { 


Make s{a\tc you 
cvcv-y 
delegate -to 
rwakc su\rc 
i^t’s 灼 。七 hull— 

o-thcv-wisc, i-t 

^ould "th\row 3 
null Yt^tYtY\Ct 


private BatCallback hitBallCallback; 
public Bat(BatCallback calIbackDelegate) { 

this.hitBallCallback = new BatCallback(callbackDelegate); 

} 

public void HitTheBall(BallEventArgs e) { 

.___^ if (hitBallCallback ! = null) 
hitBallCallback(e); 

1 We used = instead of += because in this case, we only want one bat to listen to any 

one ball, so this delegate only gets set once. But there’s nothing stopping you from 
writing a callback that uses += to call back to multiple methods. The point of the 
callback is that the object doing the calling is in control of who’s listening. In an 
event, other objects demand to be notified by adding event handlers. In a callback, 
other objects simply turn over their delegates and politely ask to be notified. 



⑧ 


We’ll need to hook the bat up to a ball. 

So how does the Bat’s constructor get a reference to a particular ball’s OnBal 1 InPlay () method? 
Easy~just call that Ball object’s GetNewBat () method, which you’ll have to add to Ball: 


public Bat GetNewBat() { 

return new Bat(new BatCallback(OnBalllnPlay)); 

} f 

WC 卜 d’m Bat objects dohstv-udW. But 

… I 。 二 “ 叫 _七 ^ kcs b> set up the dallbadk 

method us„ 9 a publid method set 


丁 he Balls hew ^ct/VcwBatO method 
Scales a hew Ba-t objc^ av\d i-t uses 
七 he "to p^ss 3 

\rc-fc\rchdc io its owh OhBalllhPlayO 
method -to -the hCw bat. That s the 
^3llbadk method the bat will use wheh 
it hits the ball- 
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④ 


④ 


Now we can encapsulate the Ball class a little better. 

It’s unusual for one of the On . . . methods that raise an event to be public. So let’s follow that 
pattern with our ball, too, by making its OnBalllnPlay () method protected: 


protected void OnBalllnPlay(BallEventArgs e) { 

EventHandler<BallEventArgs> balllnPlay = BalllnPlay; 

if (baiiinPlay != null) TWis k a \rcall7 sla^dav-d 70^1' 

balllnPlay (this, e) ; scc oVev > ovcv- a^a'm v/Kcn Y ou 如仏 


Ker Masses. ^ a .Ker dass Kas ar, cve^-t 


All that’s left to do is fixing the BaseballSimulator class. 

Baseball Simulator can’t call the Ball object’s OnBalllnPlay () method anymore — 
which is exactly what we wanted (and why the IDE now shows an error). Instead, it needs to ask 
the Ball for a new bat in order to hit the ball. And when it does, the Ball object will make sure 


that its OnBall InPlay () method is hooked up to the bat’s callback, 
public void PlayBall() { 

Bat bat = ball.GetNewBat(); ^ — * ^ 

BallEventArgs ballEventArgs = 

new BallEventArgs(Trajectory, Distance); 
bat.HitTheBall(ballEventArgs); 


the BdsebdlISinf»ul3*tov "fco hi*t 

a Ball object, it y\ttds -fco gei a hew 
Bat objedi -Pv-orw ihai ball. The ball y/ill 
make suv-c that 七 he dallbadk is hooked uf 
"to the bat Now y/hdrt tails "the bats 
Hi-tThcBallO i-t tails -the ball’s 

I^PlayO rwethod, >nW\cM -fives i-ts 
BalllnPlay ewt. 


Now run the program — it should work exactly like it did before. But it’s now protected from 
any problems that would be caused by more than one ball listening for the same event. 

Bu 七 do^*t *takc ouv* y/ovd -fov 1 七一 fof rt o^tv\ m dcbu^cv-f 


BULLET POINTS - 

■ When you add a delegate to your project, you’re 
creating a new type that stores references to methods. 

■ Events use delegates to notify objects that actions have 
occurred. 

■ Objects subscribe to an object’s event if they need to 
react to something that happened in that object. 

■ An EventHandler is a kind of delegate that’s really 
common when you work with events. 

■ You can chain several event handlers onto one event. 
That’s why you use += to assign a handler to an event. 

■ Always check that an event or delegate is not null before 

you use it to avoid a NullRef erenceException. 


■ All of the controls in the toolbox use events to make 
things happen in your programs. 

■ When one object passes a reference to a method to 
another object so it—and only it—can return information, 
it’s called a callback. 

■ Events let any method subscribe to your object’s events 
anonymously, while callbacks let your objects exercise 
more control over which delegates they accept. 

■ Both callbacks and events use delegates to reference 
and call methods in other objects. 

■ The debugger is a really useful tool to help you 
understand how events, delegates, and callbacks work. 
Take advantage of it! 
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those design patterns sound useful 


You can use callbacks with MessagePialog commands 


When you create a UI Command for a Me s sage Dialog, you can give it a callback using the 
UICommandlnvokedHandler delegate. You can also pass it an optional identifier object, and the 
label and identifier are accessible through the IUI Command delegate parameter. 


MessageDialog dialog = new MessageDialog( "Here's a dialog."); 

dialog.Commands.Add (new UICommand("My label" ^ MyUiCommandCallback^ "My identifier") ); 
await dialog.ShowAsync(); TK.s be ^ 

七 jus*t a 


thereiare no o 

Dumb Questions 


Try adding these 
lines to an app. 
You can use the 
Generate Method 
Stub IDE command 
to generate a stub 
for the callback 
method. 


How are callbacks different from events? 

A! Events and delegates are part of .NET. They’re a way for one 
object to announce to other objects that something specific has 
happened. When one object publishes an event, any number of other 
objects can subscribe to it without the publishing object knowing or 
caring. When an object fires off an event, if anyone happens to have 
subscribed to it, then it calls each of their event handlers. 

Callbacks are not part of .NET at all—instead, callback is just a name 
for the way we use delegates (or events—there's nothing stopping 
you from using a private event to build a callback). A callback is just a 
relationship between two classes where one object requests that it be 
notified. Compare this to an event, where one object demands that it 
be notified of that event. 

So a callback isn’t an actual type in .NET? 

A! No, it isn’t. A callback is a pattern— W's just a novel way of 
using the existing types, keywords, and tools that C# comes with. Go 
back and take another look at the callback code you just wrote for 
the bat and ball. Did you see any new keywords that we haven’t used 
before? Nope! But it does use a delegate, which is a .NET type. 

It turns out that there are a lot of patterns that you can use. In fact, 
there’s a whole area of programming called design patterns. A lot of 
problems that you’ll run into have been solved before, and the ones 
that pop up over and over again have their own design patterns that 
you can benefit from. 


So callbacks are just private events? 

A! Not quite. It seems easy to think about it that way, but 
private events are a different beast altogether. Remember what 
the private access modifier really means? When you mark 
a class member private, only instances of that same class 
can access it. So if you mark an event private, then other 
instances of the same class can subscribe to it. That’s different from 
a callback, because it still involves one or more objects anonymously 
subscribing to an event. 

But it looks just like an event, except with the event 
keyword, right? 

The reason a callback looks so much like an event is that 
they both use delegates. And it makes sense that they both use 
delegates, because that’s C#’s tool for letting one object pass 
another object a reference to one of its methods. 

But the big difference between normal events and callbacks is 
that an event is a way for a class to publish to the world that some 
specific thing has happened. A callback, on the other hand, is never 
published. It's private, and the method that’s doing the calling keeps 
tight control over who it’s calling. 


Check out “Head First Design Patterns” at the Head First Labs website. It’s a great 
way to learn about different patterns that you can apply to your own programs. The 
first one you’ll learn about is called the Observer (or Publisher-Subscriber) pattern, 
and it’ll look really familiar to you. One object publishes information, and other 
objects subscribe to it. Events are the C# way of implementing the Observer pattern. 


You’ll often see delegates used with anonymous methods and lambda 
expressions. Flip to leftover #9 in the appendix to learn more about them. 
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The Case of the Golden Crustacean 

Hoik) did the other treasure hunters beat Henry to the crab? 

The crux of the mystery lies in how the treasure hunter seeks his quarry. But 
first we’ll need to see exactly what Henry found in the stolen diagrams. 

In a stolen set of class diagrams, Henry discovers that the GoldenCrab class raises 
a RunForCover event every time anyone gets close to it. Even better, the event includes 
NewLocationArgs, which detail where the crab is moving to. But none of the other 
treasure hunters know about the event, so Henry figures he can cash in. 



class GoldenCrab { 


public delegate void Escape(object sender, NewLocationArgs e); 
public event Escape RunForCover; 


public void SomeonesNearby() { 

Escape runForCover = RunForCover; 
if (runForCover != null) 

runForCover (this, new NewLocationArgs ("Under the rock ，，）； 

} 

} 

class NewLocationArgs { 

public NewLocationArgs(HidingPlace newLocation) { 
this.newLocation = newLocation; 



s ^cohc dories 
"to the goldch 的 b, 
its SomcohcsKcav-byO 

R^Covcir 3r)d 
t.hds a ylacc h> hide. 


private HidingPlace newLocation; 

public HidingPlace NewLocation { get { return newLocation; } } 


So how did Henry take advantage of his newfound insider information? 


Henry adds code to his constructor to register his treasure_RunForCover() method as an event handler for the 
RunForCover event on the crab reference he’s got. Then, he sends a lowly underling after the crab, knowing it 
will run away, hide, and raise the RunForCover event~giving Henry’s treasure_RunForCover() method all the 
information he needs. 


class TreasureHunter { 

public TreasureHunter(GoldenCrab treasure) { 


treasure.RunForCover += treasure_RunForCover; 


void treasure_RunForCover(object sender, 
MoveHere(e.NewLocation); 

} 

void MoveHere(HidingPlace location) { 

// ... code to move to a new location 


NewLocationArgs e) { 

^ 払 — ne was b— dlcvc^r by al W5 W, s 

das/s acW 孙 e 鄕 t ‘出伙 

his Movcttc\rcO method every time i\\t tv-ab raises its 

… Ru^FovCovcy event But lie 

-tveasuve Wrrbevs -fv-om i\\t same dlass, his 
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And that explains why Henry’s plan backfired. When he added the event handler to the 
TreasureHunter constructor, he was inadvertently doing the same thing for all of the treasure 
hunters! And that meant that every treasure hunter’s event handler got chained onto the same 
RunForCover event. So when the Golden Crustacean ran for cover, everyone was notified about the 
event. And all of that would have been fine if Henry were the first one to get the message. But Henry had 
no way of knowing when the other treasure hunters would have been called — if they subscribed before he 
did, they’d get the event first. 
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how charming 


Use delegates to use the Windows settings charm 

Go to the Windows 8 Start Page and tap the Internet Explorer icon, then open up the charms and tap 
Settings. Internet Explorer told Windows 8 to add options like Internet Options and About to the Settings 
charm menu. But when you click the IE About option, it looks very different from the About page for the 
Maps, Mail, or Windows Store apps. That’s because it’s up to each app — and, in fact, each page — to tell 
Windows about its Settings charm options and register a callback that gets called when the user chooses the 
option. G# Windows Store apps use delegates to do this. Let’s use the IDE to explore how this works and 
add an About command to the Settings charm for Jimmy 5 s app. 

Open up MainPage.xaml.es and add these two using statements and this line of code to the constructor: 

using Windows.UI.ApplicationSettings; 
using Windows.UI.Popups; 

III <summary> 

III A basic page that provides characteristics common to most applications. 

Ill </ summary> 

public sealed partial class MainPage : JimmysComics 3 .Common.LayoutAwarePage 


public MainPage() 

{ 

this.InitializeComponent(); 

SettingsPane.GetForCurrentView().CommandsRequested += MainPage CommandsRequested; 


SettingsPane is a static class that lets your app add 
or remove commands to the Settings charm. It’s in the 
Windows .UI .ApplicationSettings namespace. 


When you type += the IDE will prompt you to automatically create the event handler method stub. Here’s 
what should go into that event handler. It uses a delegate called UICommandlnvokedHandler, so add 
a method called AboutlnvokedHandler () • That’s the method that will get called by the About setting. 

void MainPage 一 CommandsReques ted (SettingsPane sender. Settings PaneCommandsRequestedEventArgs args) { 
UICommandlnvokedHandler invokedHandler = 

new UICommandlnvokedHandler(AboutlnvokedHandler); 

SettingsCommand aboutCommand = new SettingsCommand("About n , "About Jimmy's Comics ", 

invokedHandler); 

args.Request.ApplicationCommands.Add(aboutCommand); 

} 

async void AboutlnvokedHandler (IUICommand command) { 

await new MessageDialog("An app to help Jimmy manage his comic collection ", 

"Jimmy 1 s Comics") .ShowAsync(); 
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Now run your app. Open up the charms, tap Settings, and then choose the About menu option. Your app 
will call AboutlnvokedHandler and display the Message Dialog. 


W\\cy\ you *to ma'm 

pay, *taf Setti 呼 

dhavm, *thc shows 

By\ w /\bou*t of*tior> W 七 

pofs uf a Mcssa^cPialo^ 

you dhoosc l*t- 

Now let’s use the IDE to explore how this works. Stop the program and use Go To Definition to get the 
definition of SettingsCommand from metadata. It should look like this: 


Jimmy's Comics 

Choose a query to run 


Jimmy's Comics 



You can use the Windows key (: :) 
to access the charms and app bar. 

★ Bring up the charms with j j + I 

★ Pop up the Settings charm with j j + I 

★ Display the App Bar with j j + Z 


public sealed class SettingsCommand : lUIComimand 


Ipublic SettingsCommand (object settingsComimandld^ string label j UICommandlnvokedHandler 


… .public object Id { get; set; } 

ublic UICommandlnvokedHandler Invoked { get j set ; 
ublic string Label { get; set j } 


Now use Go To Definition again to see the definition of UICommandlnvokedHandler: 


public delegate void UICommandlnvokedHancIler ( 工 UICcmmand command)j 


Walk through the various objects so you can see exactly how this works: 

* The SettingsPane . GetForCurrentView () method returns an object that has 
a CommandsRequested event. Go back to your code and then go to the definition of 
CommandsRequested to see the event definition. 

* The event handler has a SettingsPaneCommandsRequestedEventArgs argument. Go into its 
definition to see the Request object that’s used in the third line of your event handler. 

* The Request object has one property: a collection called ApplicationCommands that contains 
SettingsCommand objects. 

* Go back to your event handler again, because now you can see what it does. When the user taps 
the Settings charm, the settings pane fires its CommandsRequested event to ask apps for 
commands and callbacks. You hooked a listener up to this event, and had that listener return a 
SettingsCommand that defined the About option, with a delegate that pointed to a method to pop 
up a Mess age Dialog. When you tap About, the settings pane uses that delegate to call back to 
AboutlnvokedHandler() • 

* Still not 100% clear? Don’t worry. Use the ® " ® navigation buttons in the toolbar to navigate back 
and forth through the definitions. Try putting a breakpoint in the constructor and the two methods. 
Sometimes you need to flip back and forth through the definitions before it all “clicks” in your brain. 


handler); 
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Apps can interact with the Search and Share charms, too! Flip to leftover #1 
in the appendix to find out where to learn more about it. 
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Great apps on the inside and outside ^ 



Your apps need to be more than just visually stunning. 


When you think of design, what comes to mind? An example of great building 
architecture? A beautifully-laid-out page? A product that’s as aesthetically 
pleasing as it is well engineered? Those same principles apply to your apps. 

In this chapter you’ll learn about the Model-View-ViewModel pattern and 
how you can use it to build well-architected, loosely coupled apps. Along the 
way you’ll learn about animation and control templates for your apps’ visual 
design, how to use converters to make data binding easier, and how to pull it 
all together to lay a solid C# foundation to build any app you want. 


this is a new chapter 
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brian and jimmy get chippy 

The Head First basketball Conference needs an app 

Jimmy and Brian are the captains of the two top teams in the Head First Basketball Conference, 
Objectville’s amateur basketball league. They’ve got some great players, and those players 
deserve a great app to keep track of who’s starting and who’s on the bench. 


^c\\ -team l^as player 

av\d bewh playcv-s, ar\d tacM 
playev" has a 3y\d 3 ^umbev". 


Head First Basketball Conference 


The Amazins 

The Bombers 

Starting Players 

Starting Players 

Jimmy #42 

Brian #31 

Henry # 11 

Lloyd #23 

Bob #4 

Kathleen # 6 

Lucinda #18 

Mike # 0 

Kim #16 

Joe #42 

Bench Players 

Bench Players 

Bertha #23 

Herb #32 

Ed #21 

Fingers # 8 



Thcvc a\rc -Pou\r di-f^CVC^i Lisi\/icv/ 
乙 oirrbrols on ihis page, so OY\C 

needs its owr> Obscv-vablcCollcdtio^ 

to b*md its licmsSouv-tc -fco. 
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Put caw they agree on how to build it? 


Uh oh — Brian and Jimmy have different ideas about how to build this app, and the 
argument’s starting to get a little heated. It sounds like Brian really wants it to be 
easy to manage the data that’s displayed on the page, while Jimmy cares a lot about 
simplifying the data binding. This may make for a great off-court rivalry, but it’s not 
going to make it any easier to build the app! 




IT SBBMS PESTTY 
OBVIOUS TO MB THAT VJB 
NEED TO MAKE IT EASY TO 
ADD DATA, 



Jimmy: Hold on there, cowboy. Sounds a little short-sighted. 

Brian: I’m sure you just don’t understand what I’m telling you, so I’ll 
talk real slow and spell it out for you. We’ll start with a simple Player 
class that has properties for the name, number, and whether the player’s a 
starter. 

Jimmy: Yes, I understand what you’re saying. But you’re not listening to me. 
You’re thinking about how to model the data. 

Brian: Clearly. That’s where everything starts. 

Jimmy: That makes it convenient to create the data. 

Brian: You’re getting it — 

Jimmy: I’m not done. What about the rest of the app? We’ve got 
ListView and TextBlock controls that need to display the data. If we don’t 
have collections for the controls to bind to, they won’t work. 

Brian: Um … 

Jimmy: Exactly. So we may need to make a couple of, ah, tactical 
decisions in our object model. 

Brian: You mean, we need to compromise by creating a lousy object 
model that’s hard to work with, because we need something to bind to. 

Jimmy: Unless you’ve got a better idea. 

How can you create classes that are easy to bind to, but still 
have an object model that makes it easy to work with the data? 


you are here ► 
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thafs not a hammer 


Vo you design for binding or for working with data? 

You already know how important it is to build an object model that makes your data easy to work 
with. But what if you need to do two different things with those objects? That’s one of the most 
common problems that you face as an app designer. Your objects need to have public properties 
and ObservableCollections to bind to your XAML controls. But sometimes that makes your 
data harder to work with, because it forces you to build an unintuitive object model that’s difficult to 
work with. 


Player 


Roster 

Name: string 

Number: int 

Starter: bool 


TeamName: string 

Players: IEnumerable<string> 





It’s hard to optimize your classes 
to make it easy to slice and dice 
your data with LINQ queries... 

var benchPIayens = 

from player in _roster,Players 
where player.Starter == false 
select player; 


|-f you model yoiA\r 

da*ta like tWis, i*t 




lim'i-b youv- abilit/ *to 
build pays 






l*f you model youv* 

like this, 


casiev- -fco build youv* 
pages but ha\rdc\r -fco 
w\ritc Code -fco 

the data. 



...if you also need to be able 
to bind that data to the XAML 
controls on your app’s pages. 



Player 


Roster 


League 

Name: string 

Number: int 


TeamName: string 

Starters: 

ObservableCollection 

Bench: 

ObservableCollection 


JimmysTeam: Roster 
BriansTeam: Roster 




It would be vcally 
"fco have 

Private methods 
hc\rc -fco 
dummy dd'tol- 
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MVVM lets you design for binding awd data 


Almost all apps that have a large or complex enough object model face the problem 
of having to either compromise the class design or compromise the objects 
available for binding. Luckily, there’s a design pattern that app developers use to 
solve this problem. It’s called Model-View-ViewModel (or MWM), and it 
works by splitting your app into three layers: the Model to hold the data and state 
of the app, the View that contains the pages and controls that the user interacts 
with, and the ViezvModel that converts the data in the Model into objects that can 
be bound and listens for events in the View that the model needs to know about. 


that uses the existing 
tools you alv-cady have ； 
just like the dallbadk a^d 
Obsc\rvc\T faltcv-hs ih the 
last dhaptev-. 



Any object that the user directly 
interacts with goes in the View. 

That includes pages, buttons, text, grids, 
StackPanels, ListViews, and any other 
controls that can be laid out using XAML. 
The controls are bound to objects in the 
ViewModel, and the controls’ event handlers 
call methods in the ViewModel objects. 



The ViewModel has the properties 
that can bind to the controls in 
the View. 

The properties in the view get their data 
from the objects in the Model, convert that 
data into a form that the View’s controls can 
understand, and notify the View when the 
data changes. 



All of the objects that hold the 
state of the app live in the Model. 

This is where your app keeps its data. The 
ViewModel calls the properties and methods 
in the Model. If there are objects that change 
over the course of the app’s lifetime, or if data 
needs to be saved or loaded from files, those 
things go here. 


Tke 

ViewModel 
is like tke 


plumbing 


tkat connects 
tke objects in 


tke View to 
tke objects 
in tke Model, 


usingf tools 
you alreacty 
know kow to 
work witk. 
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apply the pattern 


New Item... Ctrl+Shift+A 

Existing Item... Shifts Alt+A 

New Folder 

Class... Shift+Alt+C 


UsGthc MVVM pattern to start building 
the basketball roster app 

Create a new Windows Store app and make sure it’s called BasketballRoster 

(because we’ll be using the namespace BasketballRoster in the code, and this 
will make sure your code matches what’s on the next few pages). 


CeBATB THB Vievo, AMO FtPLOSeS IM THB p^jbct^ 

Right-click on the project in the Solution Explorer and choose New Folder from the Add menu: 





Don’t replace MainPage.xaml with a Basic 
Page vet . You’ll do that in step #4. 



Add a Model folder. Then do it two more times to add 
the View and ViewModel folders, so your project looks 
like this: > 

These -Poldcv-s will hold 
•the dlasscs, dor>*tvols, 
BY\d -Pov youv aff. 


企 T © ▼ # 麵 _ A 

>earch Solution Explorer (Ctrk；) 

Solution 'BasketballRoster' (1 project) 


Search Soluti 

Solutioi 


p 


A Propertie 
Referenci 
篇 Assets 
£ Commor 
D App.xam 
pi Basketba 
^ MainPag 
|3 Package. 


Solution Explorer Ch 



Build 

Rebuild 

Deploy 

Run Code Analysis 



Scope to This 

New Solution Explorer View 



Add 

► 


Add Reference... 



Add Service Reference... 



Store 

► 

由 

Manage NuGet Packages... 


o 

Set as StartUp Project 

Debug 

► 


Add Solution to Source Control... 


X 

Cut 

Ctrl+X 

X 

Remove 

Del 

DC：：：! 

Rename 

F2 


Unload Project 



Open Folder in File Explorer 

Open in Blend... 



Properties 


P 


When you use the Solution 
Explorer to add a new 
folder to your project, 
the IDE creates a new 
namespace based on the 
folder name. This causes 
the AdcHClass … menu 
option to create classes 
with that namespace.So if 
you add a class to the Model 
folder, the IDE will add 
BasketballRoster.Model 
to the namespace line at 
the top of the class file. 


f2r T © - # W 圈 圖 P P 

Search Solution Explorer (Ctrl+;) 

Solution 'BasketballRoster' (1 project) 

J 网 Basketba 11 Roster 
P A Properties 
P References 

> Assets 


p 



Si View 
SI ViewModel 

^A|jp.Adri lP 

p] BasketballRaster 一 TemporaryKey_pftc 
P MainPage.xaml 

HeI Package.appxmanifest 

Solution Exp I or er Class Vi ew 


Mode 


orer 


So utiDn 


Solution Explorer 


:p + a^ V 
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architecting apps with the mvvm pattern 


O START BUlUV>lbi& THB BY At>t>lbJ^ THB PUAYBIS CUASS^ 

Right-click on the Model folder and add a class called Player. When you add 
a class into a folder, the IDE updates the namespace to add the folder name to the 
end. Here’s the Player class: iVhch you add a dass 

namespace BasketballRoster.Model { -Polder -the IDB adds -the 

class Player { ' *Polde\r r\3rtne io the hdmespdde. 

public string Name { get; priva - 
public int Number 

public bool Starter { get; private set; 


{ get ； 

private 

set; 

} 

{ get ； 

private 

set; 

} 


public Player(string name, int number, 
Name = name; 

Number = number; 

Starter = starter; 


bool starter) 



Player 


Name: string 
Number: int 
Starter: bool 


pi-p-(*cvcr>*t classes tOY\tCTY\td 

This sounds -Pamiliav... 


These classes are small because they’re only 
concerned with keeping track of which players are 
in each roster. None of the classes in the Model are 
concerned with displaying the data, just managing it. 


O FINISH THB BYAt>t>IN^ THB IS^STBIS CUASS 

Next, add the Roster class to the Model folder. Here’s the code for it. 

namespace BasketballRoster.Model { 
class Roster { 

public string TeamName { get; private set; } 

private readonly List<Player> —players = new List<Player>() 
public 工 Enumerable<Player> Players { 

get { return new List<Player>( players); } 


The 一 -tells you 

*this -Picld- 

is f\riva*tc- 


Roster 


TeamName: string 
Players: IEnumerable<string> 


public Roster(string teamName, 工 Enumerable<Player> players) L 
TeamName = teamName; 

^ . —players.AddRange(players); 


\ 


Your Model folder should now look like this: 




We added an underscore to the beginning 
of the name of the _j>layers field. Adding 
an underscore to the beginning of private 
fields is a very common naming convention. 

We’re going to use it throughout this 
chapter so you can get used to seeing it. 


m £] Model 

> C # Player.cs 

> C* Roster.cs 


Well add the view on the next pa^e 


-► 
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take control of your controls 




O /?£>£> THB MAIN PA 公 5 TO THB Vievj F^>Ut>e^ 

Right-click on the View folder and add a new Basic Page called LeaguePage.xaml. You’ll 
be prompted to add missing pages and will need to rebuild the solution, just like when you 
replace MainPage.xaml with a new Basic Page. Edit the XAML and give the page the title 
“Head First Basketball Clonference” by changing the AppName static resource (as usual). 
We’re not going to use MainPage.xaml, so you’ll delete it in the next step. 



O t>BUBTB THB MAIN PA&B ANt> J^SPUACB IT WIITH Y£>UR NBW! 

PA 站 - 

Delete the MainPage.xaml file from the project. Now try rebuilding your project — you’ll get an error: 


Error List 


T ▼ O 1 Error ! 0 Warnings 0 Messages Search Error List 



Description ▲ 

nie 

Line 

Column 

Project 

3 

1 The type or namespace name 'MainPage' could not be fotind [are 
you missing a using directive or an assembly reference?} 

App.xaml.es 

67 

4S 

BasketballlRoster 


Error List Output 


Double-click on the error to jump to the line that broke when you deleted MainPage.xaml'. 

if (! root Frame. NavigateftypeofCMainPa^ge)^ a rgs .Arguments)) 

{ ——一 

throw new Except ion f 11 Failed to create initial page"); 

} 

Wait a minute, you know what that code does! You modified it when you built the app for Jimmy. It’s 
looking for a MainPage class to navigate to when the app launches, but you just deleted the XAML file 
that defines that class. No problem! Just specify the class that you want to launch: 

if (! rootFrame.Mavigate(typeof (LeaguePage) ^ args*Arguments)) 

{ — 

throw new Exception ( ,r Failed to create initial page"); 

} 

Hmm, that’s strange. You added the LeaguePage to the project, but it’s not being recognized. That’s 
because you added it to a folder, so the IDE added it to the View namespace. So all you need to do is 
specify the namespace when you refer to the class: 

if (! rootFrame.Navigate(typeof (View. LeaguePage) ^ args.Arguments)) 

{ 

throw new Exception ( ,r Failed to create initial page"); 

} 

Now try rebuilding your app. It compiles! You can run it to see your new main page show up. 
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User controls let you create your own controls 


Take a look at the basketball roster program that you’re building. Each team gets an 
identical set of controls: a TextBlock, another TextBlock, a ListView, another TextBlock, 
and another ListView, all wrapped up by a StackPanel inside a Border. Do we really need 
to add two identical sets of controls to the page? What if we want to add a third and fourth 
team — that’s going to mean a whole lot of duplication. And that’s where user controls 
come in. A user control is a class that you can use to create your own controls. You use 
XAML and code-behind to build a user control, just like you do when you build a page. 
Let’s get started and add a user control to your BasketballRoster project. 

o Add a new user control to your View folder. 

Right-click on the View folder and add a new item. Choose 
the dialog and call it RosterControl. xaml. 

❾ Look at the code-behind for the new user control. 

Open up RosterControl xaml cs. Your new control extends the UserControl base 
class. Any code-behind that defines the user control’s behavior goes here. 

namespace BasketballRoster.View 
{ 

public sealed partial class RosterControl : UserControl 
{ 

public RosterControl() 

{ 

this .InitializeComponent(); 


❺ Look at the XAML for the new user control. 

The IDE added a user control with an empty <Grid>. Your XAML will go here. 



from 


UserControl 
is a Lase class 


tkat gives 
you a way to 
encapsulate 
controls tkat 
are related 


to eacli otker, 
and lets you 
Imilct logic 
tkat cteiines 
tke tekavior 
oi tke control. 


Before you flip the page, see if you can figure out what 
XAML should go into the new RosterControl by looking 
at the screenshot of the program that you’re building. 

* It will have a <StackPanel> to stack up the controls that live 
inside a blue 〈 Border〉. Can you figure out which property gives 
a Border control rounded corners? 

* It has two ListView controls that display data for players, so it also 
needs a 〈UserControl • Resources 〉 section that contains a 
DataTemplate. We called it Player I temTemplate. 

* Bind the ListView items to properties called Starters and 
Bench, and the top TextBlock to a property called TeamName. 

* The Border control lives inside a <Grid> with a single row that 

has Height= M Auto" to keep it from expanding past the bottom 
of the ListView controls to fill up the entire page. , 
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xV TBACH A MAM TO FISH—" 

We're nearing the end of the book, 
so we want to challenge you with 
problems that are similar to ones 
you’ll face in the real world. A good 
programmer takes a lot of educated 
guesses, so we’re giving you barely 
enough information about how 
a UserControl works. You don’t 
even have binding set up, so you 
won’t see data in the designer! How 
much of the XAML can you build 
before you flip the page to see the 
code for RosterControl? 






model view viewmodel 




❺ Finish the RosterControl XAML. 

Here’s the code for the RosterControl user control that you added to the View folder. Did you 
notice how we gave you properties for binding, but no data context? That should make sense. The two 
controls on the page show different data, so the page will set different data contexts for each of them. 


<UserControl 

x:Class= M BasketballRoster.View.RosterControl 


xmlns= M http :// schemas.microsoft.com/winfx/2 00 6/xaml/presentation" 
xmlns : x= M http :// schemas.microsoft.com/winfx/2006/xaml M 
xmlns:local= M using:BasketballRoster.View" 

xmlns : d= M http :// schemas.microsoft.com/expression/blend/2008" 

xmlns : mc= M http :// schemas.openxmlformats.org/markup-compatibility/2006 M 


me : 工 gnorable= n d n 
d : DesignHeight= M 300 M 
d : DesignWidth= M 4 00 M > 



You alv-cady k^ov/ 七 ha 七 doy>*tvols s*iz< based oy\ 七 heiv 

pvofcv'tics. You tdiy\ y>umbcv*s *to dl'tcv* \\o^n doh*tvol 

is displayed m i\\t IDE’S Pcsi^cv- w'mdow youVc modi-fyrnj it 



<UserControl.Resources 〉 

<DataTemplate x : Key= n PlayerItemTemplate n > 


<Run Text= 
<Run Text= 
<Run Text= 
</TextBlock> 
</DataTemplate> 
</UserControl.Resources 〉 


{Binding Name}"/> 
# M /> 

{Binding Number} M /> 



Heire’s -the "tcrwplatc -pov -the i-terws 
ihc L\sW'\c^i dohiirols. Bach 
Ime has a single Tc^tBlodk with 
七 hiree vu^s -to display the playcr ; s 

扒 3 灼 d r^urwbcV". 


<Grid> 

<Grid.RowDefinitions> 

<RowDefinition Height= M Auto M / > 

</Grid.RowDefinitions> 

<Border BorderThickness= M 2 M BorderBrush= M Blue M CornerRadius= M 6 M Margin= n 0,0,40,0 n > 
<StackPanel Margin= M 20 M > 

<TextBlock Text= M {Binding TeamName} M 

Style= M {StaticResource HeaderTextStyle} M /> 

<TextBlock Text= M Starting Players M 

Style= M {StaticResource GroupHeaderTextStyle} M Margin= M 0,20,0,0 n /> 
<ListView ItemsSource= n {Binding Starters} M 

— 工 temTemplate= n {StaticResource PlayerltemTemplate} M Margin= n 0,20,0,0 n /> 
<TextBlock Text= M Bench Players M 

Style= M {StaticResource GroupHeaderTextStyle} M Margin= M 0,20,0,0 n /> 
<ListView 工 temsSource= n {Binding Bench}’’ 

— ^ 工 temTemplate= n {StaticResource PlayerltemTemplate} M Margin= n 0,20,0,0 n /> 

</StackPanel> 

</Border> 

</Grid> 

</UserControl> 


L*lS*t\/'lC>W - 
doyrbroU use 
same 

dc-f med as a 

s*ta*t'id VCSOUVdC- 1 


You use 七 he Cov-^cv-Radius 
pv-opev-ty -to jive a Bov-dcv- 
V"ou 灼 ded to\r^c\rs. 
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Build the ViewModel for the BasketballRoster app by looking at the data in the 
Model and the bindings in the View, and figuring out what “plumbing” the app 
needs to connect them together. 


③ UPt>ATB TO At>t> THB 1SOSTB1Z CObiTIZOUS 

First add these xml ns properties to the page so it recognizes the new namespaces: 



xmlns : view= M using : BasketballRoster.View" 

xmlns : viewmodel= n using:BasketballRoster.ViewModel 


Then add an instance of LeagueViewModel as a static resource: 

<Page.Resources 〉 

<viewmodel : LeagueViewModel x : Name= M LeagueViewModel M /> 

<x : String x : Key= M AppName M >Head First Basketball Conference</x : String> 
</Page.Resources 〉 


Now you can add a StackPanel with two RosterControls to the page: 

<StackPanel Orientation= M Horizontal" Margin= n 120,0,0,0 n Grid.Row= M 1 M 
DataContext= M {StaticResource ResourceKey=LeagueViewModel} M > 

<view : RosterControl DataContext= M {Binding JimmysTeam} M Margin= n 0,0,20,0 n /> 

<view : RosterControl DataContext= M {Binding BriansTeam} M Margin= n 0,0,20,0 n /> 

</StackPanel> 

/Wake suv-c you Crtaicd 七 he classes and pages 
’m 七 he -Poldc\rs ； oihc^rv/isc, ihc 的 amespades 

o CJZBATB TUB VievoM^t>eu CUASSBS^ wo 〆 七 w 七乩七 k 匕 ode m the solu-tio^. 

Create these three classes in the ViewModel folder. 


PlayerViewModel 


RosterViewModel 

Name: string 

Number: int 

TeamName: string 

Starters: ObservableCollection 
〈 PlayerViewModel 〉 

Bench: ObservableCollection 

〈 PlayerViewModel 〉 


constructor: 

RosterViewModel(Model. Roster) 

private UpdateRostersf) 


LeagueViewModel 

JimmysTeam: RosterViewModel 
BriansTeam: RosterViewModel 


private GetBomberPlayers(): Model.Roster 
private GetAmazinPlayers(): Model.Roster 


O MAKe we VievoM^eu CUASSBS 

★ The PlayerViewModel class is a simple data object with two read-only properties. 


Flip a 

badk -fov a 
iVm 七 abou 七 

•the ■ 

'ucvy … 


The LeagueViewModel class has two private methods to create dummy data for the page. It 
creates Model. Roster objects for each team that get passed to the RosterViewModel constructor. 

The RosterViewModel class has a constructor that takes a Model. Roster object. It sets the 
TeamName property, and then it calls its private UpdateRosters () method, which uses LINQ 
queries to extract the starting and bench players and update the Starters and Bench properties. 
Add using Model ; to the top of the classes so you can use objects in the Model namespace. 


If the IDE gives you an error message in the XAML designer that LeagueViewModel 
does not exist in the ViewModel namespace, but you’re 1 00% certain you added 
it correctly, try right-clicking on the BasketballRoster project and choosing Unload 
Project, and then right-click again and choose Reload Project to reload it. 


you are here 
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exercise solution 


E%ef(ciS< 


内 jrciSs 

^PLytipH 


The ViewModel for the BasketballRoster app has three classes: LeagueViewModel, 
PlayerViewModel, and RosterViewModel. They all live in the ViewModel folder. 

namespace BasketballRoster.ViewModel { 
using Model; 

using System.Collections.ObjectModel; 


If you left out the using Model; line 
then you’d have to use Model. Roster 
instead of Roster everywhere. 


Lcajuc\/ic>wA1odcl exposes 
Ros-tcv-\/ic>wModcl objects/ 
"that a Ros-tcv-Coh-tvol 

use as i*b daia 乙 ohtext 


class LeagueViewModel { 

public RosterViewModel BriansTeam { get; private set; 
public RosterViewModel JimmysTeam { get; private set; 


public LeagueViewModel() { 

Roster briansRoster = new Roster("The Bombers M , 
BriansTeam = new RosterViewModel(briansRoster); 


GetBomberPlayers()) 


I 七 dveates 七 he Roster 
model objcd*t -Po\r the 
Ros-tcv-\/ic>wMoclcl -fco use- 


Roster jimmysRoster= new Roster("The Amazins M , GetAmazinPlayers()); 
JimmysTeam = new RosterViewModel(jimmysRoster); 


This p\rivaic rweihod 
jc^cv-aics dummy 
dd'td -Pov- 七 he 
Bombc\rs by dv-catmg 
B Lis-t o( 

Playcv- obje^-ts. 



private IEnumerable<Player> GetBomberPlayers() { 

List<Player> bomberPlayers = new List<Player>() { 

new Player("Brian", 31, true) , 
new Player("Lloyd" , 23, true ), 
new Player("Kathleen ", 6 , true ), 
new Player("Mike " f 0 , true ), 
new Player( M Joe" , 42, true) , 
new Player (’ ’Herb ”， 32, false ), 
new Player("Fingers",8, false ), 

}； 

return bomberPlayers; 


Dummy data typically goes in 
the ViewModel because the 
state of an MVVM application 
is managed using instances 
of the Model classes that 
are encapsulated inside the 
ViewModel objects. 


You use classes -from 
the \/\v*i *to store 
youv whidh 

is why -this method 
\rc*tu\r^s Playcv- 

objects 灼。七 

PlaycvVicv/Modcl 




private 工 Enumerable<Player> GetAmazinPlayers() { 

List<Player> amazinPlayers = new List<Player>() 
new Player("Jimmy ", ^2, true ), 
new Player("Henry" ,11, true ), 
new Player ("Bob" , 4 f true) , 
new Player("Lucinda", 18, true ), 
new Player( M Kim M , 16, true ), 
new Player("Bertha", 23, false ), 
new Player( n Ed n ,21, false ), 

}； 

return amazinPlayers; 


namespace BasketballRoster.ViewModel { 
class PlayerViewModel { 


tWs the Playcv-l/icw/Hodcl. li J s just a 

simple data objed-t with piropcvtics -fov- 
七 he dsis template "to bihd "to. 


public string Name { get; private set; } 


public int Number { get; private set; } 


public PlayerViewModel(string name, int number) { 
Name = name; 

Number = number; 
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namespace BasketballRoster.ViewModel { 
using Model; 

using System.Collections.ObjectModel; 
using System.ComponentModel; 


In a typical MVVM app, only classes in the ViewModel 
implement INotifyPropertyChanged because those 
are the only objects that XAML controls are bound to. 


class RosterViewModel : INotifyPropertyChanged { 

public ObservableCollection<PlayerViewModel> Starters { get; private set; } 
public ObservableCollection<PlayerViewModel> Bench { get; private set; } 


private 


private 


Roster 


string 


roster; This is wiwe 七 aff siovcs its state—m Rosicv- objedis 

er>daf>sula*kedi msidc \/ic>wA1odcl. The v*cs*t o*f the dass -tva^sla-tcs 
teamName - 七 ^ Model data *m*to fVofC\r*tiCS ihai i\)t bmd *to. 


public string TeamName { 

get { return _teamName; } 

set { 

_teamName = value; 
OnPropertyChanged("TeamName"); 



I/Vhc>r>cvc\r -the Tcarw/s/amc property 

-the Rosic\r\/icwModcl -Piv-cs o(( 
a P\ropc\rtyChar>gcd so a^y objedi 
bou^d -to ii v/ill gei updated. 


public RosterViewModel(Roster roster) { 
roster = roster; 


Starters = new ObservableCollection<PlayerViewModel>(); 
Bench = new ObservableCollection<PlayerViewModel>(); 


TeamName = roster.TeamName; 


UpdateRosters (); 


private void UpdateRosters() { 

var startingPlayers = 

from player in roster.Players 
where player.Starter 
select player; 

Starters.Clear (); 

foreach (Player player in startingPlayers) 

Starters.Add(new PlayerViewModel(player.Name 


This L|/V^ 

-fi^ds dll ihc stav-tmj 
players av\d adds 
them -to ihc S-ta\rtcv-s 
Obsc\rvablcCollcdiior> 
p\ropc\rty. 


player.Number)); 


var benchPlayers = 

from player in roster.Players 
where player.Starter == false 
select player; 

Bench.Clear (); 

foreach (Player player in benchPlayers) 

Bench.Add(new PlayerViewModel(player.Name , 


〜代 ’s a sW’lav L>IN 公 

c^uCV"Y -f »V\d 

\)tu\\ flaycv-s. 

player.Number)); 


public event PropertyChangedEventHandler PropertyChanged; 

protected void OnPropertyChanged(string propertyName) { 

PropertyChangedEventHandler propertyChanged = PropertyChanged; 
if (propertyChanged != null) 

propertyChanged(this, new PropertyChangedEventArgs(propertyName)); 
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oop really works 


ISM^ A USBR COm^OL, BASI6AUUY JUST A WAY 
TO SPLIT y<9UR XAMU ACROSS A FBW FIUBS? 


User controls are fully functional 
controls that you build. 

And like every other control, a user control is an 
object — in this case, an object that extends the 
UserControl base class, which gives you familiar 
properties like Height and Visibility, and 
routed events like Tapped and PointerEntered. 
You can also add your own properties, and you can use 
the other XAML controls to make very intricate, even 
visually stunning, user interfaces. But most importantly, 
a user control lets you encapsulate those other 
controls into a single XAML control that you can reuse. 
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VOAIT A MIMUTB...THIS STUFF ABOUT 
BN^APSUUATI^N AND SBPARATIN^ OBJECTS INTO 
UAYBRS SOUNDS RBAUUY FAMILIAR. X>OBS THIS HAVB 


TO WITH SBPARATI^N OP C£>NCB^NS ? 


That’s right! The Model, View, and ViewModel 
divide up the concerns of the program. 

One of the most challenging parts of designing a large, robust 
app is choosing which objects do what. There are an almost 
infinite number of ways to design your app. That’s great, because 
it means that G# gives you flexible tools to work with. But it’s 
also a challenge, because today’s decisions can make tomorrow’s 
changes very difficult to manage. MWM helps you separate the 
concerns about the data in your app from the concerns about its 
UI. This makes it easier to design your app by helping you figure 
out exactly where data goes and where UI elements go, and by 
giving you patterns to help connect them together. 


a bo one dlass v-c<\u^cs 

•to bno move, 乩払⑼ v-c<\u'iv-c mov-c . 

-to additional dlasscs, a -fov *tKat 

Pvoyammcvs dall it suy^v-y/' a^d it s 

vevy cspcdially 4 ⑼ youVc m d Wvry. 

Chapter 16 


Scpava-tio^ o-f Coutrvys is a v/ay *to ⑼七 
? voblems like tKat a^d MWM is a v^y us^ul 
-tool *to Kelp you sepavate some 从…护 

aUosi cvcv-y aff is dontcvr>cd 
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Dumb Questions 

^^:So what’s stopping me from 
putting controls in the ViewModel or 

ObservableCollections in the 

Model? 

Nothing at all—except that once 
you do, you’re no longer using the MVVM 
pattern. Classes like controls and pages are 
concerned with displaying the data. If you put 
them in the View, that makes it easier for you 
to manage your codebase as your app grows 
larger. When you trust the MVVM pattern 
today, your life is better tomorrow because 
your code is easier to manage. 

still don’t get what state means. 

^\^lWhen people talk about state they 
mean the objects in memory that determine 
how your app functions: the text in a text 
editor, the location of the enemies and player 
and the score in a video game, the values 
of the cells in a spreadsheet. This is actually 
a tough concept to wrap your brain around, 
because it’s sometimes difficult to say “this 
object is part of the state” and “that object 
isn’t.” One of the goals of the next project 
in this chapter is to help you get a practical, 
realistic handle on what state really means. 

Why do I need using Model ； at 
the top of my ViewModel classes? 

When you created classes in the Model 
folder, the IDE automatically created them 
in the BasketballRoster . Model 
namespace. The dot in the middle of that 
namespace means that Model is underneath 
BasketballRoster. Any other class in a 
namespace under BasketballRoster can 
access classes in Model by either adding 
Model, to the beginning or adding a using 
line. Outside the BasketballRoster 
namespace, classes will need to add using 
BasketballRoster . Model ; instead. 


Q^-Can my user control contain other 


controls? 


^\^lYes, it can. You can add content, just 
like you add content to any other control: 


<view : RosterControl> 

<TextBlock>Hello!</TextBlock> 
</view:RosterControl> 


This sets the Content property of the user 
control to the TextBlock object. But if you 
try doing this, your RosterControl will 
suddenly be replaced with a TextBlock! 


Adding a <UserControl. 
ContentTemplate> section to your 
UserControl’s XAML fixes this. Stick a 
DataTemplate in that section with the 
XAML for your control. This line: 


<ContentPresenter 

Content= M {TemplateBinding 
Content} M /> 

will be replaced with the contents. 

I keep seeing a triangle with an 
exclamation point on my page. What’s 
that about? 

y\^lThe IDE’s XAML designer is a pretty 
sophisticated piece of machinery. It works 
so well that we sometimes forget just how 
much work it has to do to display a page and 
update it as we modify the XAML. Now that 
the BasketballRoster program is finished, 
the designer shows you the dummy data 
for both teams. But wait a minute—isn’t that 
dummy data created in private methods in 
the ViewModel? That means the designer 
must be running those methods every time 
it updates the page. So in order for it to be 
able to run properly, those methods have to 
be compiled. If you modify the controls that 
are on the page, then the latest C# code, 
hasn’t been compiled yet, so the designer is 
telling you that the page that it’s displaying 
may be out of date. Rebuild the code and the 
exclamation points usually disappear. 


Q^-The BasketballRoster app I just built 
only has dummy data that’s created when 
it starts up. What if I want to add a feature 
to modify the data in the Model—how 
would that work? 


Let's say you wanted to modify your 
BasketballRoster program to let Jimmy 
and Brian trade players. You already know 
that the ListView controls in the View are 
bound to ObservableCol lection 
objects, so the ViewModel communicates 
with the View using PropertyChanged 
and CollectionChanged events. 

And you can have the Model communicate 
with the ViewModel in exactly the 
same way. You could add an event, 
RosterUpdated, to the Roster 
object. The RosterViewModel would 
listen to that event, and its event handler 
would refresh the Starters and Bench 
collections, which would then fire off 
CollectionChanged events, which 
would update the ListView controls. 


Events are a good way for the Model to 
communicate to the rest of the app because 
the Model doesn’t need to know if any 
other classes are listening to the event. It 
can go about its business managing the 
state, and let some other class worry about 
getting input and updating the user interface 
because it’s decoupled from the classes in 
the ViewModel and the View. 


Wken you trust 

tke MVVM pattern 

today, your project 
will te tetter 
tomorrow, tecause 
your app’s code will 
te easier to manage. 


The Mode 卜 View-ViewModel design pattern is actually adapted from another 
pattern called Model-View-Controller. You can learn all about the MVC pattern in 
the GDI+ PDF, which you can download from the Head First Labs website. 


you are here ► 


759 



model versus viewmodel 


Fireside Chats 




Tonight’s talk： A Model and a ViewModel have a heated debate 
over the critical issue of the day, “Who’s needed more?” 


Model: 


ViewModel: 


I’m not quite sure why we’re even having this discussion. 

Where would you be without me? I’ve got the data; I’ve 
got the important logic that determines how the app 
works. Without me, you’d have nothing to do. 

There you go again, thinking that you’re the center of the 
universe. 

Well, as far as you’re concerned, I may as well be. 

Ha! What would happen if I decided to stay home? 

You wouldn’t dare. 

Try me! Without me, you’d be useless. The View would 
have no idea how to talk to you. The controls would be 
empty, and the user would be left in the dark. 

Now you know why I only speak to you through events. 

You’re just so annoying! 

You know what? Let’s talk about that for a minute. Why is 
it that you can’t even let me see your internals? You only 
expose methods and properties to me, and you’ll only ever 
send me messages through event arguments. 

Of course I do! If I didn’t encapsulate my data, who 
knows what damage you might cause? 


It sounds like someone has trust issues. 


Absolutely! I don’t trust anything except my own private 
methods to manage my data; otherwise, the whole state 
of our app could go haywire. But I’m not the only one 
who plays this game! Why don’t you ever let me talk to 
the View? He seems like a good guy. 


How dare you! Why, raise PropertyChanged 
events? No self-respecting Model has ever raised a 
PropertyChanged event! I’m insulted you’d even 
suggest I’m concerned with anything but data. What 
kind of layer do you think I am? 


You barely even speak the same language as the View! 

I’ve never seen you fire a PropertyChanged event — in 
fact, I don’t think any of your objects even implement 
INotifyPropertyChanged. 
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The ref needs a stopwatch 

Jimmy and Brian had to call off their last game because the 
referee forgot his stopwatch. Can we use the MVVM pattern to 
build a stopwatch app for them? 




Hows -the 

io 

七 he "tKlrCC—SCdohd 
V*ule without it? 


you are here ► 
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what does state really mean? 


MVVM means thinking about the state of the app 

MWM apps use the Model and View to separate the state from the user interface. So when you 
start building an MWM app, the first thing you usually do is think about exactly what it means to 
manage the state of the app. Once you’ve got the state under control in your brain, you can start 
building the Model, which will use fields and properties to keep track of the state — or everything 
the app needs to keep track of to do its job. Most apps need to modify the state as well, so the 
Model exposes public methods that change the state. The rest of the app needs to be able to see 
the current state, so the Model provides public properties. 

So what does it mean to manage the state of a stopwatch? 


The stopwatch knows 
whether or not it’s running. 


You can see at a glance whether or 
not the hands are moving, so the 

stopwatch Model needs to have a The elapsed time is 

way to tell whether or not it’s running. always available. 



Whether it’s the hands on an 
analog stopwatch or numbers 
on a digital one, you can 
always see the elapsed time. 


The lap time can 
be set and viewed. 

Most stopwatches have a 
lap time function that lets 
you save the current time 
without stopping the clock. 
Analog stopwatches use an 
extra set of hands to show 
the lap time, while digital 
stopwatches usually have a 
separate lap time readout. 


The stopwatch can stop, start, and reset. 

The app will need to provide a way to start the stopwatch, 
stop it, and reset the time, which means the Model will 
need to give the rest of the app a way to do this. 


Tke Model keeps 
track ol tke state 
ol tke app ： wkat 
tke app knows 
rigfkt now. It 
provides actions 
tkat modily tke 
app’s state and 
properties to 
let tke rest oi 


tke 


app see 
current state. 


tke 
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Start buildmg the stopwatch app's Model 

Now that we know what it means to define the state of a stopwatch, we have enough information to 
start to build out the Model layer of the stopwatch app. Create a new Windows Store app. Name 
the app Stopwatch so your namespaces match the code on the next few pages. Then create the 
Model ， Vieuu ， and ViezvModel folders. Add the StopwatchModel class to the Model folder: 



class StopwatchModel 
private DateTime? 





These *two 
p\riva*tc 
-fields hold 
•the s*ta*tc 

s*topy/a*tdh- 
ThcyVc bo*th 
nullable. 


started; l 一 /1/Iakc suirc you the dlass m the /Wodd 

private TimeSpan? previousElapsedTime; ^ out "the { } Imcs 


[s 參 


public bool Running { 

get { return started.HasValue; 


public TimeSpan? Elapsed { 
get { 

if ( started.HasValue) 


bedduse you khow y/ha 七 they look like- 

Wlc ^ould use 3^ Boolean -field *to keef *tv-a^k 

whctiicv- ov 竹 o*t s-topy/a*tdh is But that -field 

would o^ly be tv-uc i-f *thc — stav-ted f ield has a value, so 
v/hy ⑽七 jus*t use __stav-*tcd ttas\/aluc mstcad? 


previousElapsedTime; 


if (_previousElapsedTime.HasValue) 

return CalculateTimeElapsedSinceStarted() 

else 

return CalculateTimeElapsedSinceStarted () ; 丁 ^ read—o^ly pv-opcv*ty uses 


else 


return previousElapsedTime; 


private TimeSpan CalculateTimeElapsedSinceStarted() 
return DateTime.Now - started.Value; 


public void Start() { 

_started = DateTime.Now; 

if (! previousElapsedTime.HasValue) 


七 y/o pyivatc -fields *to taltula'tc 
eld^sed tiw'C- Look dloscly 3*t it 
Ca^ you -f i^uve ou*t hoy/ i 七 v/ovks? 


HtvVs a v/^cr> you add or 
subVatt PatcTirwc ov TimcSpa^ 
values ； you always (\ti a Time£\>ay>- 




previousElapsedTime = new TimeSpan(0); 


Rcscttmj 
仏 c s*ta*tc 

rv\Cd^S 

sc*ttmg i*ts 
-fields *bo - 

灼 ull. 


public void Stop () { 

if (—started•HasValue) 

—previousElapsedTime +: 
started = null; 


DateTime.Now - 


The tresi of -the app r^ccds {p 
be able bo sta\rt s-fcop 七 he 
s-topy/a^h, so the Alodd pv*ovidcs 
^ methods {x> do ihai- 

started. Valued- 


public void Reset() { 

—previousElapsedTime 
started = null; 


null 


public StopwatchModel() { 

Reset (); 

1 This m'rbializjes o-f d 

S*topy/a*UhModcl as \rcsc*t shopped. 


參 




Timc£pah 3 hd DsicTimnC stvufrts 

two v^y us^ul sWts 4, W ih ah 

7 vc al ^ d Y With VaicT^ whidh a 

^ 了伽 is ah i‘val oUiM The i‘val 

，S t' a t，dk iS ° hC 七〜 

OY iv )0 A°L hcks w' 11 ' 冰。 hd )> s 。心 TimcS fah has 

methods to dohV^rt \j jo sedQhds, milliscdohds, days, tit. 
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layers communicate with events 




Evewts alert the rest of the app to state changes 

The stopwatch needs to track the lap time, so it needs to store that time as part of the state. It also 
needs a method to get the lap time. But what happens if we want the rest of the app to do a few 
things when the lap time is triggered? The ViewModel may want to turn on an indicator or show 
a quick animation. The Model will often use an event to tell the rest of the app about 
important state changes. So let’s add an event to the Model that gets fired whenever the lap 
time is updated. Start by adding the LapEventArgs to the Model folder: 



class LapEventArgs : EventArgs { 

public TimeSpan? LapTime { get; private set; 
public LapEventArgs(TimeSpan? lapTime) { 
LapTime = lapTime; 


Wcrcs 七 he LapEverrt/Wgs 
dass. Make suve b> add i't "to 
■the Alodcl -foldcv so i*t cirtds 

“pm "the to\r\rc^-t Mrwesp 把 C. 


lap is updated ； 
r^ccds *to kr\ov/ 

elapsed ； so i*t Kas a TimcSpa^ 

pvopcvty *to s*tovc 


Modify your StopwatchModel class to add a Lap () method that 
sets the LapTime property and fires a LapTimeUpdated event. 


public void Reset () { 

_previousElapsedTime 
_started = null; 

LapTime = null; 


null 



Make suv-c -the 
LapTW p\ropcv-ty is 
v-csc*t -the v-cs*t 
o( s*fcopwa*t^h 
state jets v-csct 


The LafO 
method 
updates 七 he 
fv-ofcv-*ty 
ay>d *f iv*es 
七 he cwt. 


public TimeSpan? LapTime { get; private set; 


public void Lap() { 

LapTime = Elapsed; 
OnLapTimeUpdated(LapTime) 


/U au-fconr»atid p\ropc\rty will be just 
1/Vc dojr /七 r\ccd a pv-ivaic -field 

because theve a^y dakulaiiohs 
that heed -to be encapsulated. 


public event EventHandler<LapEventArgs> LapTimeUpdated; 

private void OnLapTimeUpdated(TimeSpan? lapTime) { 

EventHandler<LapEventArgs> lapTimeUpdated = LapTimeUpdated; 
if (lapTimeUpdated != null) { 

lapTimeUpdated(this, new LapEventArgs(lapTime)); 


This is jus 七 the usual Code 
ho -five cvcht 


A nice side effect of decoupled 
layers is that your project can build 
as soon as the Model is complete. 
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Tke Model 

can lire an 
event to tell 
tke rest oi 
tke app about 
important 
state ckangfes 
witkout any 
reierences to 
classes outside 
tke Model. 

It’s easier to 
Luild because 
it’s JecoupleJ 
from tke rest 
oltke MWM 
layers. 


If the IDE tells you that StopwatchViewMode 1 does not exist in the ViewModel namespace 
but you’re 1 00% sure that you put it there, try unloading and reloading the project. 




architecting apps with the mvvm pattern 

Puild the view for a simple stopwatch 

Here’s the XAML for a simple stopwatch control. Add a user control to the View folder 
called BasicStopzvatch. xaml and add this code. The control has TextBlock controls to 
display the elapsed and lap times, and buttons to start, stop, reset, and take the lap time. 




<UserControl 

x : Class 二 , ’Stopwatch . View. BasicStopwatch" ^~~~' 

xmlns = M http :// schemas.microsoft.com/winfx/2 00 6 / xaml/presentation" 
xmlns : x= n http://schemas.microsoft.com/winfx/2006/xaml M 
xmlns : local= M using : Stopwatch.View" 

xmlns : d= M http :// schemas.microsoft.com/expression/blend/2008" 

xmlns : mc= M http :// schemas.openxmlformats.org/markup-compatibility/2006 


This £.o^*tvol is \ y \ the 
\/icw -foldcv- u^dcv- youv- 


me : 工 gnorable= n d n 
d : DesignHeight= M 300 M 
d : DesignWidth= M 400 M 

xmlns : viewmode1= M using : Stopwatch.ViewModel M > 


V^ull r\ttA 七 his p\ropcv-ty -fco add 七 he 

Mmespade. Wit called ouv S-fcopwa-t^h, so 

■the \/icv/A1odld is S-bopy/a-tdhViewModel- 


<UserControl.Resources 〉 

<viewmodel : StopwatchViewModel 
</UserControl.Resources 〉 


x : Name= M viewModel M / > 


<Grid DataContext^' 
<StackPanel> 

<TextBlock> 

<Run>Elapsed time : 
<Run Text= M { 

<Run> : </Run> 

<Run Text= M { 

<Run> : </Run> 

<Run Text= M { 
</TextBlock> 
<TextBlock> 


{ StaticResource ResourceKey=viewModel} ▼’> 



This user control stores an 
instance of the ViewModel as a 
static resource and uses it as its 
data context. It doesn’t need its 
container to set a data context. 
It keeps track of its own state. 


This Tc^iBlodk is bound 
"to p\ropc\rtics 七 he 

\/icv/Modcl 七 ha 七 \rciuv-^ 
"the elapsed -time. 




<Run>Lap time : </Run> 

<Run Text= M {Binding LapHours} M /> 

<Run> : </Run> 

<Run Text= M {Binding LapMinutes} M /> 

<Run> : </Run> 

<Run Text= M {Binding LapSeconds} M /> 

</TextBlock> 

<StackPanel Orientation= M Horizontal M > 

<Button Click= M StartButton_Click M >Start</Button> 

StopButton_Click M >Stop</Button> 
ResetButton_Click M >Reset</Button> 
LapButton Click M >Lap</Button> 


TiVis Tt%{S>\ock 
is bour\d *to 

pvopcv-tics 七 
expose laf tiw'C- 


The (/icW^odel 
•^us-fc be -fiv-ihg o^-f 
Pv-opcirtyChahgcd 

cvch*ts -fco keep these 
values up -to date. 


<Button Click 
<Button Click 
<Button Click 
</StackPanel> 

</StackPanel> 

</Grid> 

</UserControl> 


a use a Pispatdhcv-Timcv- *to do^sta^tly 
the y\/Iodcl ar\d update the pv-opcv-tics. 


You’ll need to add Click event 
handlers to the control and a 
StopwatchViewModel class 
to the ViewModel namespace 
_for this to compile._ 


The code for the ViewModel is on the next page. How much of the ViewModel code 


can you build just from the View and Model code before you flip the page? Add a 
BasicStopwatch control to the main page ( for now) and see how far you can get. 


But be really careful and don’t assume the IDE is necessarily wrong. Sometimes an error in the 
XAML for one page (like a broken xmlns property) can cause all of the designers to break. 


you are here ► 
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build the viewmodel 




Add the stopwatch ViewModel 


Here’s the ViewModel for the stopwatch. Make sure it goes in the ViewModel namespace. 


class StopwatchViewModel : 工 NotifyPropertyChanged { 

private StopwatchModel _stopwatchModel = new StopwatchModel(); 

private DispatcherTimer 一 timer = new DispatcherTimer(); 

public bool Running { get { return 一 StopwatchModel.Running; } 

public StopwatchViewModel() { 

_timer •工 nterval = TimeSpan.FromMilliseconds(50); 

_timer.Tick += TimerTick; 

_timer.Start(); 

Start(); 


The Ruirmmg 

fv-ofev-ty 

the Model b> see 

i-P stopwatch 

is 





You’ll Y\ttA these 

-Pov the dlass *to 
Compile. \ 


using Model; 

using System.ComponentModel; 
using Windows•UI.Xaml; 


StopwatchModel.LapTimeUpdated += LapTimeUpdatedEventHandler; 


public void Start () { 

_stopwatchModel.Start (); 


public void Stop () { 

_stopwatchModel.Stop (); 


public void Lap () { 

_stopwatchModel.Lap (); 



The S*tav-*tO, S*topO, by\A 
LafO methods jus*t pass 
*thv"Ou^h "to methods 
model- 


public void Reset() { 

bool running = Running; 
_stopwatchModel.Reset(); 
if (running) 

_stopwatchModel.Start(); 


The RcsctO rwrthod -Piv-s-t tails 

the /Model’s RcsctO rwethod, the 灼 

^ ^alls i-fcs S-ta\rtO wthod i*P 七 he 
s-topy/a-Uh >was alv-cady vwrmm 》 


int —lastHours; 
int —lastMinutes; 
decimal —lastSeconds; 

void TimerTick(object sender, object e) 
if (—lastHours != Hours) { 

_lastHours = Hours; 
OnPropertyChanged("Hours M ); 

} 

if (—lastMinutes != Minutes) { 

_lastMinutes = Minutes; 
OnPropertyChanged("Minutes M ); 

} 

if (—lastSeconds != Seconds) { 

_lastSeconds = Seconds; 
OnPropertyChanged("Seconds"); 


public int Hours { 



Ev/e\ry *tinr»C 七 he Dispatdhc\rTirwc\r 

iidks, -the \/icv/Modcl dhcdks -to see 


i-f "the hou\rs, rw'mu-tcs, a^d sedor\ds 


have l-P they have, i-t -fives 

o(( 七 he \ri3h 七 PvopcirtyClia^jcd 

so 七 “e \/ic>w 乙扣 update itsd-P- 


This ? : syntax lets you fit a conditional 
on a single line, and it works just like an 
if statement. Flip to leftover #2 in the 
appendix to learn more about how it works. 



get { return _stopwatchModel.Elapsed.HasValue ? —StopwatchModel.Elapsed•Value•Hours 


0 ; } 
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public int Minutes { 

get { return stopwatchModel.Elapsed.HasValue ? stopwatchModel.Elapsed.Value.Minutes 


0 ; 


public decimal Seconds { 
get { 

if (_stopwatchModel.Elapsed.HasValue) { 

return (decimal) stopwatchModel.Elapsed.Value.Seconds 

+ ( stopwatchModel.Elapsed.Value.Milliseconds * .001M); 


ElapscdValuc v-rtuv-^s a TimcSpa^ av\d 

its M'mu-tcs p\ropc\rty \rctu\nr\s By\ 


else 


return 0.0M; 


\ The Scdo^ds p\ropcv-ty v-c*tu\nr\s -the 

plus o( a se^o^d as a decimal• 

Se 七 a bveakpo’m 七 a 灼 d use 七 he dcbu^cv -fco 
c^plovc how i 七 wov-ks. 


public int LapHours { 

get { return stopwatchModel.LapTime.HasValue ? stopwatchModel.LapTime.Value.Hours 


0 ; 


public int LapMinutes { 

get { return stopwatchModel.LapTime.HasValue ? stopwatchModel.LapTime.Value.Minutes : 0; 


public decimal LapSeconds { 
get { 

if (—stopwatchModel.LapTime•HasValue) { 

return (decimal)—stopwatchModel.LapTime.Value.Seconds 

+ ( stopwatchModel.LapTime.Value.Milliseconds * .001M); 


else 


These p\ropc\rtics wov~k 

like the elapsed 
c properties, except 
thcyVc based ov\ LapTime 
\y\sitad o( Elapsed. 



return 0.0M; 


int —lastLapHours; 
int —lastLapMinutes; 
decimal —lastLapSeconds; 

private void LapTimeUpdatedEventHandler(object 
if (_lastLapHours != LapHours) { 

_lastLapHours = LapHours; 
OnPropertyChanged("LapHours M ); 

} 

if (—lastLapMinutes != LapMinutes) { 

_lastLapMinutes = LapMinutes; 
OnPropertyChanged("LapMinutes"); 

} 

if (—lastLapSeconds != LapSeconds) { 

_lastLapSeconds = LapSeconds; 
OnPropertyChanged("LapSeconds M ); 


sender, LapEventArgs e) { 

^ *thc ha^dlcv- -Pov- the Model’s 

LafTimcUfdatcd It wov-ks jus-t like the 

Pispa^hcv-Timc^s handler by dhcdkmj -the 

lap time pv-opcv-tics a^d v-ais'm^ Pv-opcv-tyCha^^cd 

(or only -the oy\cs that 


public event PropertyChangedEventHandler PropertyChanged; 
protected void OnPropertyChanged(string propertyName) { 

PropertyChangedEventHandler propertyChanged = PropertyChanged; 
if (propertyChanged != null) 

propertyChanged(this, new PropertyChangedEventArgs(propertyName)); 


J Hcvc ; s -the -Pamiliav- Code 
Pv-opcv-tyCha^jcd. 
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tick tick tick 


Finish the stopwatch app 


There are just a few more loose ends to tie together. Your Basic Stopwatch user control doesn’t have event 
handlers, so you need to add them. And then you just need to add the control to your main page. 


① 


O 


First, go back to BasicStopwatch.xaml.es and add these event handlers to the code-behind: 

private void StartButton Click(object sender, RoutedEventArgs e) { 


viewModel.Start(); 

} 

private void StopButton_Click(object sender, RoutedEventArgs e) { 
viewModel.Stop(); 

} 

private void ResetButton_Click(object sender, RoutedEventArgs e) { 
viewModel.Reset(); 

} 

private void LapButton_Click(object sender, RoutedEventArgs e) { 

viewModel.Lap(); 


The buttons ih 
"the view just 匕 dll 
methods ih the 
1/icwModcl- This 
•_s a p\retty typical 

pattevh -fov* the 
l/icw. 



Next, delete the MainPage.xaml file and replace it with a Basic Page, just 
like you’ve done in your other projects (don’t forget to rebuild the solution). 



⑦ 




® 


Open the new MainPage.xaml and add the XML namespace to the top-level tag: 
xmlns : view="using : Stopwatch.View" 


All o( the beholviov 
is the usev- 
^oht\rol, so thcv-c s 


Modify the AppName resource in MainPage.xaml to set the page name: 
<Page.Resources 〉 

<x : String x : Key= n AppName n >Stopwatch</x : String 〉 
</Page.Resources 〉 

Add a BasicStopwatch control to the XAML code in MainPage. xaml: 
<view : BasicStopwatch Grid.Row= M 1 M Margin= n 120,0 n /> 


y^o dodc-bchihd 
K the maih pcl^e- 




Solution Explorer 



^ t q - # q 團圖 ^ p 

Search Solution Explorer (Ctrl+;) ， 


Your app should now run. Click the Start, Stop, Reset, and 
Lap buttons to see your stopwatch work. 


Stopwatch 


Elapsed time: 3:22:35.S39 
Lap time 3:6:31.002 


Start 

Stop 

Reset 

Lap 


|s Hcrcs y/V^at youv 

Solution E%\>lov-c\r should look like. 






Solution 'Stopwatch' (1 project) 



P A 1 Properties 
> ■■ References 


> 麵 Assets 

> _ Common 

^ £ Model 

> LapEventArgs.es 

卜 C # Stopwatch.cs 

J i£] View 

J B a&i cSto pwatc h .xa m I 

> tl Bas-i cSto pwatc h .xaml.es 

J t£] ViewModel 

|> StopwatchViewModd.es 

|> JQ App xaml 
J MainPage.xaml 

> ti MainPage.xaml.es 
Bill Package.appxmanife&t 

p] Sto pwatc h_Tem p o ra ryKey. pix 
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OK, VJB M5BD JO TAKB A MIMUTB AND TAUk ： AB^UT 
Y^U DB6IDBD WHAT &OBS WHBRB. VOHY DID YOU DB6IDB 
TO PUT TH5 PA^6 IN TH5 VIEW F^UDBR TN6 BASKBTBAUU 
PR^RAM, BUT NOT TH5 ST^PWAT^H? WHY DID Y^U USB A 
TIMBR f=OR THB BUAPSBD TIMB ； BUT AN BVBNT F^R THB UAP TIM6? AND 
WHY DID Y^U PUT THB TIMBR IM TH5 VIBWM^DBU AND MOT TH5 M^DBU? 

IT AUU S56MS SO ARBITSABYL 


Using a pattern like MVVM means making decisions. 

MVVM is a pattern, which means there are conventions, but not hard-and- 
fast rules that can be checked with a compiler. And it’s a flexible pattern, 
which means that there are a lot of different ways that you can implement it. 
Throughout the examples in this chapter, we’ll show you some of the more 
common things that you’ll see in an app with an MVVM architecture. And 
where we do vary things, we’ll explain why we made those decisions. The 
goal is to show you how much flexibility is — and isn’t — in the MWM pattern, 
so that you can make good decisions when you build your own apps. 


146126 A12B A FBVJ12UUBS THAT VJB^B 
UJH5N BUIUt>IN^ ^>U12 MWM APPS: 

* The Model, ViewModel, and View classes live in separate namespaces. 

* Controls and pages in the View can keep references to the ViewModel, so 
they can call its methods and bind to its properties with one- or two-way binding. 

* Objects in the ViewModel don’t store any references to objects in the View. 

* If the ViewModel has information to pass to the View, it uses PropertyChanged 
and CollectionChanged events so the bindings can update automatically. 

* ViewModel objects have references to Model objects, and can call their 
methods, as well as get and set their properties. 

* If the Model has information to pass to the ViewModel, it can raise an event. 

* Objects in the Model don’t have references to objects in the ViewModel. 

* The Model must be well encapsulated so that it only depends on other objects 
in the Model. If you delete all of the other code in the program, everything in the 
Model folder should still compile. 

* Dispatcher Timers and asynchronous code typically go in the ViewModel 
and not the Model. Code related to timing usually drives hozv the state of the app 
changes but is not actually part of the state of the app most of the time. 
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useful tools for viewmodels 


Converters automatically convert values for binding 

Anyone with a digital clock knows that it typically shows the minutes with a leading zero. Our 
stopwatch should also show the minutes with two digits. And it should also show the seconds with 
two digits, and roud to the nearest hundredth of a second. We could modify the ViewModel to 
expose string values that are formatted properly, but that would mean that we’d need to keep adding 
more and more properties each time we wanted to reformat the same data. That’s where value 
converters come in very handy. A value converter is an object that the XAML binding uses to 
modify data before it’s passed to the control. You can build a value converter by implementing the 
工 ValueConverter interface (which is in the Windows . UI . Xaml. Data namespace). Add a 
value converter to your stopwatch now. 

o Add the TimeNumberFormatConverter class to the ViewModel folder. 

Add using Windows .UI.Xaml.Data; to the top of the class, then have it implement 
the IValueConverter interface. Use the IDE to automatically implement the interface. 
This will add two method stubs for the Convert () and ConvertBack () methods. 



❺ Implement the Convert() method in the value converter. 

The Convert () method takes several parameters — we’ll use two of them. The value parameter is 
the raw value that’s passed into the binding, and parameter lets you specify a parameter in XAML. 

using Windows.UI.Xaml•Data; 


Coy\Vcv-*tcv-s 
av-c useful 
-bools -fov- 

Y ou，r 

V'icviModcl- 


This do^vcv-tev* 
k^ov/s how *fco 
dohvcvt dcdir^al 
dr\d m 七 values. Fov 
•nrt values ； you d 扣 
op-tio^ally pass m 
a fav-ametev-. 


class TimeNumberFormatConverter : IValueConverter { 

public object Convert(object value, Type targetType, 

object parameter, string language) 
if (value is decimal) 

return ( (decimal) value) . ToString ( TT 00.00 TT ); 
else if (value is int) { 

if (parameter == null) 



return ( (int) value) . ToString ( TT dl n ); 


else 


return ((int)value).ToString(parameter.ToString()) 


} 


return value 


} 


The Coir>vc\rtBadkO method is used -Pov -two—y/ay 
b’mdmj. lA/icVc y\oi us'mj that m ihis pvojcdt, so you 

乙扣 leave the method stub ds is. 


public object ConvertBack(object value, Type targetType, 

object parameter, string language) 
throw new NotlmplementedException(); 

} 


Is it a good idea to leave this NotimplementedException in your code? For 
this project, this is code that is never supposed to be run. If it does get run, 
is it better to fail silently, so the user never sees it? Or is it better to throw an 
exception so that you can track down the problem? Which of those gives you 
_a more robust app? There’s not necessarily one right answer._ 
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Add the converter to your stopwatch control as a static resource. 

It should go right below the ViewModel object: 

<UserControl.Resources 〉 

<viewmodel : StopwatchViewModel x : Name="viewModel" / > 

〈viewmode 1: TimeNumberFormatConverter x : Name= M timeNumberFormatConverter n /> 



</UserControl.Resources 〉 


The dcsijr>c\r may make you rebuild 七 he solu-tio^ 
you add -this I*mc. lr\ va\rc Cases, you 
even y\ced -to unload and reload 七 he pv-ojedt 


Update the XAML code to use the value converter. 

Modify the {Binding} markup by adding the Converter= to it in each of the <Run> tags. 
<TextBlock> 

<Run>Elapsed time : </Run> 

<Run Text="{Binding Hours, 

Converter={StaticResource timeNumberFormatConverter}} n /> 

<Run> : </Run> 

<Run Text="{Binding Minutes, 


I 士 thc\rc s >r>o pavamclcv- spedi-fied, do^i 

-foirjc-t the wbra dos\^ bv-adkcl }}. 


Converter={ S tat icRe source 

<Run> : </Run> 

<Run Text="{Binding Seconds, 

Converter={StaticResource 

</TextBlock> 


timeNumberFormatConverter}, ConverterParameter=d2} n /> 

t 

Use the Co^vc\rtcv-Rav-amc*tcv 

timeNumberFormatConver ter} }，▼/> sy^*tax. *to f3ss 3 pavametev 

•m*to the do^vcv-*tcv-. 


<TextBlock> 


<Run>Lap time : </Run> 

<Run Text="{Binding LapHours , 

Converter={ S tat icRe source timeNumberFormatConver ter}} ’▼ / > 

<Run> : </Run> 

<Run Text="{Binding LapMinutes, 


Converter={StaticResource timeNumberFormatConverter}, ConverterParameter=d2} n /> 


<Run> : </Run> 

<Run Text="{Binding LapSeconds , 

Converter={StaticResource timeNumberFormatConverter}}"/> 


</TextBlock> 

Now the stopwatch runs the values through 
the converter before passing them into the 
TextBlock controls, and the numbers are 
formatted correctly on the page. 



Elapsed tim-K 2:: 39 :03.66 
Lap time: 0 : 16 : 0042 
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converting different types 


Converters can work with many different types 

TextBlock and TextBox controls work with text, so binding strings or numbers to the Text property makes 
sense. But there are many other properties, and you can bind to those as well. If your ViewModel has a 
Boolean property, it can be bound to any true/false property. You can even bind properties that use 
enums — the IsVisible property uses the Visibility enum, which means you can also write value 
converters for it. Let’s add Boolean and Visibility binding and conversion to the stopwatch. 


Here are two converters that will come in handy. 

Sometimes you want to bind Boolean properties like isEnabled so that a control 
is enabled if the bound property is false. We’ll add a new converter called 
BooleanNotConverter, which uses the ! operator to invert a Boolean target property. 

IsEnabled= n {Binding Running, Converter={StaticResource notConverter}}" 

You’ll often want to have controls show or hide themselves based on a boolean property in 
the data context. You can only bind the Visibility property of a control to a target property 
that’s of the type visibility (meaning it returns values like visibility. Collapsed). 

We’ll add a converter called BooleanVisibilityConverter that will let us bind a control’s 
visibility property to a Boolean target property to make it visible or invisible. 

Visibility="{Binding Running, Converter={StaticResource visibilityConverter}}" 



MODIFY THE VIBWM^DBU^ TICK 5V5NT HANDL512. 

Modify the Dispatcher Timers Tick event handler to raise a PropertyChanged event if 
the value of the Running property has changed: 


int —lastHours; 
int —lastMinutes ; 


decimal _lastSeconds; 

bool _lastRunning; 

void TimerTick(obj ect sender, object 

if (_lastRunning != Running) { 
—lastRunning = Running; 
OnPropertyChanged("Running"); 




if (—lastHours != Hours) { 

lastHours = Hours; 
OnPropertyChanged("Hours"); 


if (_lastMinutes != Minutes) { 

_lastMinutes = Minutes; 
OnPropertyChanged("Minutes"); 


if (—lastSeconds != Seconds) { 

_lastSeconds = Seconds; 
OnPropertyChanged("Seconds"); 


Wlc added ihe 
cMcck -fco 
"the tirwCV". Would 
i"t rwolrc 

-to have -the 
Alodcl -five By\ 
ms-tcad? 



Theme 

Light ， 

you have 

Default 

-trouble scc'mj 

Dark 

youv usev 

Light 

doirrbrol m 

the 

High Contra sit (default) 

a ⑶七 

High Contrast White 

High Contrast Black 

theme m the 

High Contrast ^1 

Pcvidc window. 

High Contrast #2 
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ADD A ^NV512T512 THAT INV512TS B^UBAN VAUU5S. 

Here’s a value converter that converts true to false and vice versa. You can use it with 
Boolean properties on your controls like 工 sEnabled. 

using Windows.UI•Xaml•Data; 

class BooleanNotConverter : 工 ValueConverter { 

public object Convert(object value, Type targetType, object parameter, string language) { 
if ((value is bool) && ((bool)value) == false) 

return true; 

else 

return false; 

} 

public object ConvertBack(object value, Type targetType , object parameter, string language) { 
throw new NotlmplementedException(); 

} 

} 

O ADD A 6^NV512T512 THAT C^NVBETS B^UBANS lO VISIBILITY 5NUMS. 

You’ve already seen how you can make a control visible or invisible by setting its Visibility 
property to Visible or Collapsed. These values come from an enum in the Windows. ULXaml 
namespace called Visibility. Here’s a converter that converts Boolean values to Visibility values: 

using Windows.UI•Xaml; 
using Windows.UI•Xaml•Data; 




class BooleanVisibilityConverter : IValueConverter { 

public object Convert(object value, Type targetType, object parameter, string language) { 
if ((value is bool) && ((bool)value) == true) 

return Visibility.Visible; 

else 

return Visibility.Collapsed; 

} 

public object ConvertBack(object value, Type targetType, object parameter, 
throw new NotlmplementedException (); 


MODIFY y^>U12 BASIC. STOPVJfKTCW JO USB TH5 6^NV512T512S. 

Modify BasicStopwatch.xaml to add instances of these converters as static resources: 


string language) 



<viewmodel : BooleanVisibilityConverter x:Key="visibilityConverter" / > 
<viewmodel : BooleanNotConverter x:Key= M notConverter n / > 


Now you can bind the controls’ IsEnabled and Visibility properties to the ViewModeFs Running 
property: 


<StackPanel Orientation= M Horizontal M > 

<Button IsEnabled= M {Binding Running , Converter={StaticResource notConverter}} 

Click= M StartButton Click M >Start</Button> 


〈Button IsEnabled= M {Binding Running} M Click= M StopButton_Click M >Stop</Button> 
<Button Click= M ResetButton Click M >Reset</Button> 


〈Button IsEnabled= M {Binding Running} M Click= M LapButton_Click M >Lap</Button> 
</StackPanel> 


This enables 七 he 
S-tav-t burtto 灼 only 
i-f 七 he s-topwaidh 
is 


<TextBlock Text="Stopwatch is running" 

Visibility:"{Binding Running , Converter={StaticResource visibilityConverter}}"/> 


This causes a Tc%*tBlo^k *to bcdomc 
visible s-tofy/aidh is 
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looking stylish 


A style alters the appearance of a type of control 

When you build out the View layer of your app, you’re typically writing mostly XAML code. 
Those XAML controls are just objects, so it’s ddmitcly possible to build the entire View using 
nothing but G# code, but XAML is really optimized to make that job a lot easier. Let’s take a 
closer look at how this works, using an example you’ve already seen: app bar buttons. 


Start by modifying the buttons in BasicStopwatch.xaml to look like app bar buttons, just like you did 
in your other apps by adding Style=" {StaticResource AppBarButtonStyle} " and 

setting the button contents to the hex value of an icon from the Segoe UI Symbol font: 



<Button Style="{StaticResource AppBarButtonStyle}" 

工 sEnabled= n {Binding Running, Converter={StaticResource notConverter}} 

AutomationProperties.Name="Start" 

Click=" StartButton_Click">&#xEl02 ； </Button> 


<Button Style="{StaticResource AppBarButtonStyle}" 

AutomationProperties.Name="Stop" 

工 sEnabled= n {Binding Running}" Click= M StopButton—Click '， >&#xEl03 ； </Button> 

<Button Style="{StaticResource AppBarButtonStyle}" 

AutomationProperties.Name="Reset" 

Click="ResetButton_Click n >&#xElOE ;</Button 〉 

<Button Style="{StaticResource AppBarButtonStyle}" 

AutomationProperties.Name="Lap" 

工 sEnabled= n {Binding Running}" Click= M LapButton_Click n >&#xEl6D ； </Button> 


Now the buttons are round and have icons and names, just like app bar buttons: 


Elapsed fme: 0: 00 : 0.10 

Lap time 0:00:00.<X) 

© ® 

® 

㊣ 

Start Stop 

Reset 

Lap 

Stopwatch is ranning 




You learned back in Chapter 11 that there’s a static resource called AppBarButtonStyle 
defined in the file StandardStyles.xaml that got added to your project when you added the Basic 
Page. But exactly what is going on? Like everything else in your G# app, nothing is magic and 
everything has an explanation: app bar buttons use styles and control templates to define 
the look and feel for a button once and then easily apply it many times. 
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architecting apps with the mvvm pattern 

Open up StandardStyles.xaml in the IDE. The opening tag tells you that the file contains a 
ResourceDictionary, which is an object that provides your app with static resources. 

<ResourceDietionary 

xmlns= M http :// schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns : x="http :// schemas.microsoft.com/winfx/2006/xaml"> 


These sc*t*tcv-s 
SC*t the to\o\-, 

o-f any 
button *thc 
style is afflied 
to. 

Oi\\tr Co^bro\s 

use tW»s 

{p Jf 。认七 

tW»s U a 

button- 


Search for AppBarButtonStyle to find the static resource that you applied to your buttons. 
You’ll find that it’s defined with a <Style> tag. A style contains setters that set properties for 
any control the style is applied to. The Tar get Type property of the style determines what 
kind of control it applies to —— in this case, it’s ButtonBase, which the Button class inherits 
from. The style contains 〈 Setter 〉 tags to set properties of any control the style is applied to. 

<Style x : Key= M AppBarButtonStyle" TargetType= M ButtonBase"> 

<Setter Property="Foreground" 

Value="{StaticResource AppBarltemForegroundThemeBrush}"/> 



〈Setter Property= n VerticalAlignment" Value="Stretch" / > 
〈Setter Property="FontFamily M Value= M Segoe UI Symbol ，，/〉 
〈Setter Property="FontWeight" Value="Normal" / > 

<Setter Property="FontSize" Value= M 20"/> 



This static \rcsouv-dc is 
set "to a light ov- 

da\rk Colo^, oy\ 

whidh is used 

■to display -the Coy\brol 


〈Setter Property= n AutomationProperties • 工 temType ，， Value 二 n App Bar Button" / > 


⑧ 


The next 〈 Setter 〉 sets the Template property to a <ControlTemplate>. This defines the 
template for the control. When the button is drawn on the page, Windows looks in the control 
template to see what to draw, and it shows all of the controls contained in the template. 


<Setter Property="Template"> 
<Setter.Value> 



This tojrrbrol -tcrwpla-tc dfflies 
■bo Bu-tto^Basc objedts or 
theiv- subclasses (like Butfccm). 


〈ControlTemplate TargetType="ButtonBase"> 



AIT A MIMUTB, THIS SBBMS FAMILIAR. 工 

USB A C^NT^uTeMPUATS IM 6HAPTBR 1? 


Yes! You used the IDE to create a template for the enemies. 

If you look back at that code, you can see exactly how this worked. The IDE added 
the control template as a static resource named Enemy Tempi ate, and you were 
able to make the enemy control look like an alien by setting its Template property 
to point to the template. The IDE created the template with an x : Key instead of 
x : Name, so your code used the Resources collection to look it up by name. 
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fashion template 


The template uses a StackPanel to draw the actual button, which contains a Grid and a TextBlock. The 
Grid doesn’t contain any columns or rows —— it’s taking advantage of the fact that controls in the cell 
of a grid are drawn on top of each other (like you saw in the last chapter with routed events). It uses 
two glyphs from the Segoe UI Symbol font to draw the circular button: &#xE0A8 ； is a filled circle, and 
&#xE0A7 ； is an empty circle. (See for yourself in Charmap.) On top of the glyphs is a ContentPresenter 
control. When the Button object is created, this is replaced with any content you put between the 
opening and closing tags or using the Content property — it literally presents the content. 


<ControlTemplate TargetType= M ButtonBase M > 

<Grid x : Name= M RootGrid M Width= M 100 M Background= M Transparent M > 

〈StackPanel VerticalAlignment= M Top" Margin= n 0,12,0,ll n > 

<Grid Width= M 40 M Height= M 40 M Margin= n 0,0,0,5 n HorizontalAlignment= M Center M > 

<TextBlock x : Name= M BackgroundGlyph M Text= M &#xE0A8; M 

FontFamily= M Segoe UI Symbol M FontSize= M 53.333" Margin= n -4,-19,0,0 n 
Foreground= M {StaticResource AppBarItemBackgroundThemeBrush} M /> 

〈TextBlock x : Name= M OutlineGlyph M Text= M &#xE0A7; M FontFamily= M Segoe UI Symbol" 
FontSize= M 53.333 M Margin= n -4,-19,0,0 M /> 

〈ContentPresenter x : Name="Content" HorizontalAlignment= M Center" 

Margin= n -1,-1,0,0 M VerticalAlignment= M Center M / > 



</Grid> 


V® u El 03 pduse button jlyph 3s -the bu*ttor/s l3s*t 

[ F a 3 c ^ so 仏必 what joes \y\ -the Tc^tBlodk. The settevs m step Z set the 
^ -to UI Symbol. 

<TextBlock 

x: Name= n Text Label” Text= M {Temp la teBi tiding Aut omationPr ope r ties .Name} n 
Foreground= M {StaticResource AppBarItemForegroundThemeBrush} n ▲ 

Margin= n 0,0,2,0 n FontSize= M 12 M TextAlignment="Center" 

Width= M 88 M MaxHeight= n 32 n TextTrimming= M WordEllipsis M 
Style= M {StaticResource BasicTextStyle }"/> 

</ StackPanel> 


Scav-dh S*ta^dav-dS*tylcs.%aml 
-Pov A^*to^3*tio^P\ropcv-tics -to" 

see 以你 apld 


The TemplateBinding markup lets you bind properties in the control 
template to properties on the control it’s applied to —— so if you bind to Text, 
width, Foreground, etc., you can set that value on the Button and read it in 
the template. AutomationProperties gives you a few extra names to bind to. 


The AutomationProperties class is a convenient way to pass additional values into a 
control template, but it was actually intended to be used for accessibility. Read more here: 
http://msdn.microsoft.com/en-us/library/windows/apps/xaml/hh868160.aspx 
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The last two controls draw a rectangle around the whole control. One is named FocusVisualWhite, and is 
drawn with dashed lines. The other is named FocusVisualBlack, and is also drawn with dashed lines, but 
with a smaller dash pattern. You can see these rectangles when you run the stopwatch and hit the Tab key 
to switch between the buttons. 

〈Rectangle 

x : Name= M FocusVisualWhite M IsHitTestVisible= n False n 
Stroke= M {StaticResource FocusVisualWhiteStrokeThemeBrush} M 
StrokeEndLineCap= M Square" StrokeDashArray= M 1 , 1 M 
Opacity= M 0 M StrokeDashOffset= M 1.5 M /> 


〈Rectangle 

x : Name= M FocusVisualBlack 工 sHitTestVisible= n False n 
Stroke= M {StaticResource FocusVisualBlackStrokeThemeBrush} M 
StrokeEndLineCap= M Square" StrokeDashArray= M 1 , 1 M 
Opacity= M 0 M StrokeDashOffset= M 0.5 M /> 


Styles can alter every control of a specific type 

Have a look at the way the AppBarButtonStyle was defined in StandardStyles.xamh 
<Style x : Key="AppBarButtonStyle" TargetType="ButtonBase"> 

The style is added as a static resource, and given the key AppBarButtonStyle so it could be 
applied to buttons (or any class that extends ButtonBase) via the Style property. But what 
happens if you were to leave off the key? Then the style will automatically be applied to 
all classes that match the TargetType. Let’s add a style to see this in action. 


⑥ 


Open your BasicStopwatch.xaml file and edit the <UserControl. Resources> section to add a style as a 
static resource with a Targe tType of TextBlock. Have the style set the font size and weight: 

<Style TargetType= M TextBlock M > 

<Setter Property 二 ,, FontSize，' Value= M 16"/> 

〈Setter Property="FontWeight" Value= n Bold" / > 

</Style> 

As soon as you add the style, all of the TextBlock controls in BasicStopwatch set their FontSize and 
FontWeight properties to match the style: 


The style immediately 

dha 哼 s every UBi 。 乙 k 
•to set the Fb^-tSiz^ *to l^> 
BY\d a P 。 的 "to Bold- 


Elapsed time::: 
Lap time::: 


O Q ㊣ 


Star 


Stop 


Reset 


Lap 


Stopwatch is running 


Vh used the Device 

v/mdov/ 七 he IDE 

"to the "tllCrwC 

•to Light -fco make 
the dojrvbrol casicv -to 
see \y\ ihc dcsi^cv-. 
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Visual states make controls respond to changes 

When you hover over a button, it changes from being transparent to being opaque. When you 
tab to switch focus to the button, a dashed line appears around it. These things happen because 
you changed the state of the button. When you hover over it, that puts it into a state called 
PointerOver, and when you change focus it puts it into a focus state. There are lots of different 
states that a control can be in, and most controls don’t need to respond to every state. 

Controls and control templates use visual state groups to change the way the control looks and 2 
when it’s in a specific state. Buttons have a visual state group called Commonstates that include a 
state called Normal, one called PointerOver (when the pointer is hovering over the button), one 
called Pressed (when the user is actually pressing the button), and one called Disabled (when the 
button is disabled). The control template in the AppBarButtonStyle style has a <VisualStateGroup> 
section that determines how the button’s properties change when it’s in one of those common states. 

<VisualStateGroup x : Name= TT Commonstates TT > 

<VisualState x : Name= TT Normal n /> ^ —— 

〈VisualState x : Name= TT PointerOver n > 

<Storyboard> 

Animation for a property when the pointer is over the button 
Another animation for a different property for the same state 

</ Storyboard> 

</VisualState> 

<VisualState x : Name= n Pressed”> 

<Storyboard> 

Animation for a property when the button is pressed 
Another animation for a different property for the same state 
And another~~it can have many animations for properties 

</ Storyboard> 

</VisualState> 

〈VisualState x : Name= TT Disabled TT > 

<Storyboard> 

Animation for a property when the button is pressed 
Another animation for a different property for the same state 
etc. 

</ Storyboard> 

</VisualState> 

</VisualStateGroup> 


Each storyboard uses animations to modify 
properties. When the control enters the 
state, the storyboard starts the animations, 
which change the values of the properties. 


Each state is handled with a <visualState> tag, 
which contains a Storyboard. Storyboards 
control animations, and can use a timeline to 
determine when animations begin and end. 


The 匕 oh*brol doesjr /七 y\ttd 
"to do ahy-thi^j special 

m the ^ov-mal s-tatc. 
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Use PoubleAHimation to animate double values 


When you set a numeric property like Width or Height on a control in XAML, that sets the value of a 
double property on the control object. DoubleAnimation gives you a way to gradually change that 
double value from one value to another over a time period, and is often used to modify the control 
when it enters a visual state. The control template in AppBarButtonStyle uses DoubleAnimation to 
animate the focused state by changing the opacity of the two rectangles around the edge of the control from 0 
(clear) to 1 (opaque). The duration is zero, which means the animation happens instantly: 


<VisualState x : Name="Focused"> 


<Storyboard> 


This animation is 
bc'mg applied *to 
the do 灼七 \«"。1 called 

Fo^us\/isua - 


〈DoubleAnimation 

― ^ Storyboard.TargetName="FocusVisualWhite" 
Storyboard.TargetProperty= M Opacity" 
To=，T 

Duration^"0"/> 


〈DoubleAnimation 


The Opacity pvopev-ty 
is bema dhimd'ted -fvorn 
its default value {jo I- 


Storyboard.TargetName="FocusVisualBlack" 
Storyboard.TargetProperty= M Opacity" 
To= n l" 

*Duration=" 0 " / > 


</Storyboard> 
</VisualState> 


l/Vhc^ button leaves 

the Focused s-fca-tc, 
s-fcov-yboavd v-cscts a^d all 

d 灼 30 bddk bo -theiv 

•mrtial state, v/hidh m this 

匕 ase -the opadi-ty is set 

badk h> O. 


Let’s experiment with this animation to get a feel for how it works by copying the entire style to your user 
control, modifying the buttons to use the new style, and then modifying the animation: 


❶ 

O 

o 

o 

❺ 

❺ 


Copy the entire style, starting with〈Style x : Key= "AppBarButtonStyle" 

TargetType= M ButtonBase n > and ending with <Style>. Paste it into the The buttons 

<UserControl. Resources〉section of Basic Stopwatch, xaml right under the converters, and wo 的七 look 

change its key from AppBarButtonStyle to StopwatchButtonStyle. 

tedausc 七 he 

Modify the four buttons to apply the newly copied style by changing the Style property to style you 

Style= n { StaticResource StopwatchButtonStyle } n . added as a static 


Modify the DoubleAnimation tags in the Focused visual state to change it from a 
zero-duration animation to one that takes five seconds. Durations are always in the form 

hours:minutes:seconds, so change it to Duration="0 : 0 : 5" (in both animations, so 
it works with light and dark themes). 


\rcsou\rdc v/as 


Copied 扣 d pasied 
-rv-om 七 he s-tylc 
七 hey already had. 


Start your program, then use the Tab key to change focus between the buttons. The dashed 
outline should now fade in slowly over five seconds. 


Modify the animation again, this time to: Duration="0 : 0 : 0.5" AutoReverse="true" 
RepeatBehavior= M Forever" 


Run your program again. Now the focus rectangle pulses by fading in for half a second, then 
fading out for half a second. 


you are here ► 
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animate all the things 


Use object animations to animate object values 

While some properties on your controls use double values, others use objects. For example, when 
you set the Foreground property to Black, you're actually setting it to a SolidColorBrush 
object. You can see an example of this in the animation for your StopwatchButtonStyle 5 s 
Pressed visual state, which uses an Ob j ectAnimationUsingKeyFrames animation to 
change the color of the circle background glyph when the button is pressed: 

<VisualState x : Name= M Pressed M > 

<Storyboard> 

<0bjectAnimationUsingKeyFrames 

Storyboard.TargetName= M BackgroundGlyph" Storyboard.TargetProperty="Foreground "〉 

<DiscreteObjectKeyFrame KeyTime= M 0" 

Value= M {StaticResource AppBarltemPointerOverBackgroundThemeBrush}"/> 

</ObjectAnimationUsingKeyFrames 〉 

<0bjectAnimationUsingKeyFrames Storyboard.TargetName="Content" 

Storyboard.TargetProperty= M Foreground"> 

<DiscreteObjectKeyFrame KeyTime= M 0" 

Value= M {StaticResource AppBarltemPointerOverForegroundThemeBrush}"/> 

</ObjectAnimationUsingKeyFrames 〉 

</Storyboard> 



</VisualState> 


Key frame animations work by creating key frames. A key frame is a discrete event that happens at 
a specific times during the animation. You can see how this works by adding a third animation 
to the Pressed storyboard. Add this right above the closing </ Storyboard 〉 tag: 


<0bjectAnimationUsingKeyFrames 

Storyboard. TargetName= "Content" Storyboard. Tar get Property= ， 'Visibility ’，〉 
<DiscreteObj ectKeyFrame KeyTime="0:0:0" Value="Visible" / > 

<DiscreteObjectKeyFrame KeyTime= M 0:0:0.2" Value="Collapsed" / > 

<DiscreteObj ectKeyFrame KeyTime= M 0:0:0.4" Value="Visible" / > 

<DiscreteObjectKeyFrame KeyTime="0:0:0.6" Value="Collapsed" / > 

<DiscreteObj ectKeyFrame KeyTime= M 0:0:0.8" Value="Visible" / > 


</ObjectAnimationUsingKeyFrames 〉 


Run your program again. Now when you press a button, the Content glyph in the button will 
flash. Notice how the animation stops partway through if you stop pressing the button? That’s 
because the state changed back to Normal, so the animation reset to its starting point. 

Here’s an example of how a control template for a checkbox uses visual states: 
http://msdn.microsoft.com/en-us/library/windows/apps/xaml/hh465374.aspx 
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19 9 1 曹 ■ l • I « • I \f 9 1 崖曹 1 how you used 

Puild aw analog stopwatch usmg the same VicwModGl i^daia 

built -Po\r Jimmy s Corwins 

The MWM pattern decouples the View from the ViewModel, and the ViewModel from the Model. \v\ Chaptcv I 午 ^hd 
This is really useful if you need to make changes to one of the layers. Because of that decoupling, v-cuscd them -fco Cxtd^t 

you can be very confident that the changes you make will not cause the “shotgun surgery” effect andf 一 a Split Apf without 
ripple into the other layers. So did we do a good job decoupling the stopwatch program’s View from its Bv\y 

ViewModel? There’s one way to be sure: let’s build an entirely new View without changing the existing This is -the soime idea, 
classes in the ViewModel. The only change you’ll need in the G# code is a new converter in the 
ViewModel that converts minutes and seconds into angles. 



O At>t> A C^NVBIZTBIZ TO C^NVBIZT TIM5 TO AN 彡 L5S- 

Add the AngleConverter class to the ViewModel folder. You’ll use it for the hands on the face. 

using Windows.UI•Xaml.Data; 
class AngleConverter : IValueConverter { 

public object Convert(object value, Type targetType, object parameter, string language) { 
double parsedValue; 
if ((value != null) 

&& double.TryParse(value.ToString (), out parsedValue) 

&& (parameter != null)) 

switch (parameter.ToString ()) { ^ 

C 3 .s g M Hour's M ! liouV" v^luC \r O "(jo 

return parsedValue * 30; ^ 11, so h> Corw/C^rt h> By\ its 

case "Minutes” ： multiplied by lO. 

case "Seconds" : 

return parsedValue * 6; 七 and SC 匕 oy>ds *(Vo 你 

} o -to ^>0, so *tKc a 叫 le Coy\Mtrs\or\ 

return 0; . , . ^ , 

} medr^s mult’if b/’i% by 

public object ConvertBack(object value , Type targetType, object parameter, string language) { 
throw new NotlmplementedException(); 




❺ At>t> TUB NBVJ Use^CoNrizoL^ 

Add a new user control called AnalogStopwatch to the View folder and add the ViewModel 
namespace to the <UserControl> tag. Also, change the design width and height: 

d:DesignHeight="300" 
d: De s ignWidth= " 4 00 '▼ 

xmlns : vievnnodel="using : Stopwatch .ViewModel，▼> 

And add the ViewModel, two converters, and a style to the user control’s static resources. 

<UserControl.Resources 〉 

<viewmodel : StopwatchViewModel x : Name= M viewModel"/> 

<viewmodel : BooleanNotConverter x:Key= M notConverter n / > 

<viewmodel : AngleConverter x:Key= M angleConverter" / > 

<Style TargetType= n TextBlock"> 

〈Setter Property= M RenderTransformOrigin" Value="0.5,0.5"/> 

<Setter Property= M Foreground" Value="Black" / > 

<Setter Property= M FontSize" Value="20 "/ > 

</Style> 

</UserControl.Resources 〉 



you are here ► 
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transform your controls 


Q At>t> THB FACE AhJt> HAMt>S TO THB 诫 lt>- 

Modify the <Grid> tag to add the stopwatch face, using four rectangles for hands. 



keeps 
•i*t -fv-om 

*to 

-fill y/iia*tcvc\r 

•rt’s’m. 


<Grid x : Name= M baseGrid M DataContext: 
<Grid.ColumnDefinitions> 


{StaticResource ResourceKey=viewModel} M > 


〈ColumnDefinition Width= M 400 M /> 

〈 /Grid•ColumnDefinitions> 

〈Ellipse Width= M 300 M Height= M 300 M Stroke="Black" StrokeThickness= M 2 M > 

〈 Ellipse•Fill> 

<LinearGradientBrush EndPoint= M 0.5,1" StartPoint= n 0.5,0 n > 
<LinearGradientBrush.RelativeTransform> 

<CompositeTransform CenterY= M 0.5 M CenterX= M 0.5 M Rotation:’’45 n /> 
</LinearGradientBrush•RelativeTransform> 


This is the (bCc o-f "the s*fcopw3"t^h. 

H has 3 bla^k ou 七 lihe dhd 3 

grayish 3\radic^t ba 匕 kyou^d. 


:"#FFB03F3F ， 

： M #FFE4CECE' 




Offset 」 


/> 


w\mu*tc 


<GradientStop Color 
<GradientStop Color 
</LinearGradientBrush> 

</Ellipse.Fill> 

</Ellipse> 

〈Rectangle RenderTransformOrigin= M 0.5,0.5 M Width= M 2 M Height= M 150 M Fill= M Black 
〈 Rectangle•RenderTransform> 

<TransformGroup> 

<TranslateTransform Y= M -60 M /> 

<RotateTransform Angle= M {Binding Seconds , 

Converter:{StaticResource ResourceKey=angleConverter }, 
ConverterParameter=Seconds} M /> 

</TransformGroup> 

</Rectangle.RenderTransform> 

</Rectangle> 

■〈Rectangle RenderTransformOrigin= M 0.5,0.5 M Width= M 4 M Height= M 100 M Fill= M Black M > 
〈 Rectangle•RenderTransform> 

<TransformGroup> 

<TranslateTransform Y= M -50 M /> 

<RotateTransform Angle= M {Binding Minutes, 



Hcvc s {\\t stCov\A 
iiar\d. I 七 、 a \ oy \<^ 

W\i\\ a -tva^slatc 

a 灼 d vo*ta*tc 


doh-t\rol helve OhC 
Rchdc\rT\rahS-Po\rrw sc^tioh. 



Converter:{StaticResource ResourceKey=angleConverter }, 
ConverterParameter=Minutes} M /> 

</TransformGroup> 

</Rectangle.RenderTransform> 

</Rectangle> 

^Rectangle RenderTransformOrigin= M 0.5,0.5" Width= M 1 M Height= M 150 M Fill= M Yellow M > 
〈 Rectangle•RenderTransform> 

<TransformGroup> 

<TranslateTransform Y= M -60 M /> 

<RotateTransform Angle= M {Binding LapSeconds , 


Thcvc ave 
*t>wo yellow 
ka^ds -fov 

i\\t lap 



'Yellow M > 


Converter:{StaticResource ResourceKey=angleConverter }, 
ConverterParameter=Seconds} M /> 

</TransformGroup> 

</Rectangle.RenderTransform> 

</Rectangle> 

’ 〈Rectangle RenderTransformOrigin= M 0.5,0.5 M Width= M 2 M Height= M 100 M Fill 
〈 Rectangle•RenderTransform> 

<TransformGroup> 

<TranslateTransform Y= M -50 M /> 

<RotateTransform Angle= M {Binding LapMinutes, 

Converter:{StaticResource ResourceKey=angleConverter }, 
ConverterParameter=Minutes} M /> 

</TransformGroup> 

</Rectangle.RenderTransform> 

• 〈 /Rectangle 〉 ' ^ ,s ^y\ CX-fcva C\>rt\t \Y\ the middle {jo up 




TiiC Tvar>s-foVrw^voup lc*ts 
you affly multiple *tv*air>s-foV-mS 
•fco -the same doyrbrol. 


〈Ellipse Width 
</Grid> 


10 M Height= M 10 M Fill= M Black M /> 


Ihe h 严 ds overlap, i^s ai -the bottom o-f 

the rts dlrdwh last 3hd Ci^ds up oh -fcop. 
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a Brush 


architecting apps with the mvvm pattern 


Stroke 




m 

d 

□ 

o 


Editor 


The stopwatch face is filled 
with a gradient brush, just 
like the background you 
used in Save the Humans. 



% #FFE4CECE 






< Q ► 100% 


Each hand is transformed twice. It starts out 
centered in the face, so the first transform 
shifts it up so that it’s in position to rotate. 

<TranslateTransform Y= n -60 n /> 



Converter={Stat icResource ResourceKey=angleConverter }, 
Converter Par ameter=Seconds} ’▼ /> 


The second transform rotates the hand to 
the correct angle. The Angle property of the 
rotation is bound to seconds or minutes in the 
ViewModel, and uses the angle converter to 
convert it to an angle. 

J Transform 

RenderTransf... ■ 


ML 






/ 


0 


Every control can have one 
RenderTransform element 
that changes how it’s 
displayed. This can include 
rotating, moving to an offset, 
skewing, scaling its size up 
or down, and more. 


Angle -151.306 


□ 



□ Use relative values 

Apply 


Projection □ 

*0 ® 

U 

M. 



You used transforms in Save 
the Humans to change the 
shape of the ellipses in the 
enemy to make it look like 
an alien. 


0 

□ 

Y 0 

□ 

0 

□ 




Use relative values 


Apply 


Youv s*tofv/a*tdh v/*ill s*tav-*t 

as sooy> as you add 七 he 
scdoy>d bcdausc *i*t dvcatcs 
a 灼 *ms*tay>dc o-f \/*ic>w/V1odcl 
ds a s*ta*t"id vcsouvdc *fco vc 灼 dev* 
七 he doy>*tvol *m 七 he dcsi^cv. 

TV>c dcsi^cv may s*tof *i*t 

bu*t you ves 七 3V* 七 
\i by a>way 七 he 

dcs'i^cv Vmdov/ batk 
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adding resources 


Q At>t> THB BUTTONS TO TUB ST^>P)aJATCH^ 

Let’s add buttons to the analog stopwatch. They’ll use the same style you copied into Basic Stopwatch, xaml, 
but copying and pasting it again doesn’t make any sense at all. Luckily, you’ve already seen a way to deal 
with this: using a resource dictionary, just like the one that you saw in StandardStyles.xaml. So add a new 

Resource Dictionary item called StopzvatchStyles.xaml into the View folder (it’s in the same 
New Item dialog as User Control). Then cut the entire StopwatchButtonStyle from BasicStopwatch. 
xaml and paste it into your new StopzvatchStyles.xaml file. 


<ResourceDictionary 

xmlns= M http :// schemas.microsoft•com/winfx/2 00 6/xaml/presentation M 
xmlns : x= M http :// schemas.microsoft.com/winfx/2006/xaml M 
xmlns:local= n using:Stopwatch.View M > 

<Style x : Key= M StopwatchButtonStyle" TargetType="ButtonBase M > 

<Setter Property= M Foreground" Value= M {StaticResource AppBarltemForegroundThemeBrush}"/> 


</Style> 

</ResoucreDictionary> 

Next, edit App.xaml to add your dictionary to your app’s resources. When you create a new Windows 
Store app, the IDE creates the App.xaml file with a single 〈Application .Resources 〉 tag, and 
this is how your app knows about the styles in StandardStyles.xaml. Modify the tag to add your new 
resource dictionary: 

〈 Application.Resources 〉 

<ResourceDictionary> 

<ResourceDictionary.MergedDictionaries> 


<!-- 

Styles that define common aspects of the platform look and feel 
Required by Visual Studio project and item templates 

--> 


<ResourceDictionary Source= M Common/StandardStyles.xaml" / > 


<ResourceDictionary Source= n View/StopwatchStyles.xaml M /> 


</ResourceDictionary.MergedDictionaries> 

</ResourceDictionary> 

</Application.Resources 〉 


^ you add -this l*mc -to it 

the styles -f\rorw you\r hCW S-fcopwa-UhStylcs. 
乂 ami \ y\{o the apps v-csouv-dcs. 


Now you can add the buttons. You can just copy and paste the whole StackPanel into the new control. 

<StackPanel Orientation= M Horizontal" VerticalAlignment="Bottom M >^"to 


Wfc like the v/ay 

*thc bu*t*to^s look 

they overlap 
■the (set- You 
also add -them -to a 
sctoY\d rov/ m 
yid *to fu 七七 hem 
below the -fade* 


put 七 he butiohs oy\ ihc bot-fcom. 


<Button Style= M {StaticResource StopwatchButtonStyle} M 

工 sEnabled= n {Binding Running, Converter={StaticResource notConverter}} M 
AutomationProperties.Name= n Start” Click= n StartButton 一 Click”>&#xE102;</Button> 

〈Button Style= M {StaticResource StopwatchButtonStyle} M AutomationProperties.Name= M Stop M 
IsEnabled= n {Binding Running} M Click= n StopButton—Click”>&#xEl03;</Button> 

〈Button Style= M {StaticResource StopwatchButtonStyle} M AutomationProperties.Name= M Reset' 
Click= M ResetButton_Click M >&#xE10E;</Button> 

〈Button Style= M {StaticResource StopwatchButtonStyle} M AutomationProperties.Name= M Lap M 
工 sEnabled= n {Binding Running} M Click= M LapButton Click">&#xE16D;</Button> 


</StackPanel> 
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O M£>t>IFY THB C^>t>e-aeHINt> AMt> UPt>ATB THB MAIN PAt^e. 

You added buttons, but you still need to add their event handler methods. The code-behind for 

the buttons is the same as in the basic stopwatch: 

private void StartButton_Click(object sender, RoutedEventArgs e) { 
viewModel.Start(); 

} 

private void StopButton_Click(obj ect sender, RoutedEventArgs e) { 
viewModel.Stop(); 

} 

private void ResetButton—Click(object sender, RoutedEventArgs e) { 
viewModel.Reset(); 

} 

private void LapButton—Click(object sender, RoutedEventArgs e) { 

viewModel.Lap(); 


Now you just need to modify your MainPage.xaml to add an AnalogStopwatch control: 

<StackPanel Orientation= M Vertical" Grid.Row="1" Margin= n 120,0 n > 
<view : BasicStopwatch Margin= ， '0,0,0,40 n / > 

<view : AnalogStopwatch/> 

</StackPanel> 


Run your app. Now you have two stopwatch controls on the page. 


Eadh stopv/atdh keeps 
its ovm because 
oy\C has its ovm 


sepav-ate o-f 


■the \/icy/Modcl as a 

匕 \rcsou\r£.C. 



Try changing the ViewModel to 
make the —stopwatchModel field 
static. What does this change 
about how the stopwatch app 
behaves? Can you figure out 
_why that happens?_ 


Stopwatch 

Elapsed time: 0:13: 58.53 
Lap time: 0 : 01 : 07.36 

Q ® ® ㊣ 

Stop Reset Lap 

Stopwatch is running 



you are here ► 
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in the end, it’s all just code 


Ul controls can be mstantiated with C 4 * code, too 


You already know that your XAML code instantiates classes in the Windows . UI namespace, 
and you even used the Watch window in the IDE back in Chapter 10 to explore them. But 
what if you want to create controls from inside your code? Well, controls are just objects, so you 
can create them and work with them just like you would with any other object. Go ahead and 

modify the code-behind to add markings to the face of your analog stopwatch. 


using Windows . UI; < - Y^> u the l/V'mdov/s.U| -Pov- 七 he Colovs dlass ； -the 

using Windows . UI. Xaml. Shapes; W … dows.IXl.〆 ； 州 I.Shapes -fov ihc 

using Windows . UI. Xaml. Media ; 扣 d the lVmdoy/s.M|.><a^l/Wcdia ^a^espade (or SolidColovBvuslv 


public sealed partial class AnalogStopwatch : UserControl { 


public AnalogStopwatch() { 

this. 工 nitializeComponent() 

AddMarkings(); < — 


This dveates 
mstdhdcs of 七 he 
same Rcdtahjlc 
object that you 
v/i 七 h -the 
<Rcdtahjlc> tag. 


private void AddMarkings () { 

for (int i = 0; i < 360; 
Rectangle rectangle : 
rectangle.Width = (i 



A1odi-Py the ^OhS'tvud'tov 
^11 3i method that 
adds the md\rkm^s. 


% 


+= 3) { 

new Rectangle() 

30 == 0) ? 3 : 


1/ 



This statement uses the 
% modulo operator to 
make the marks for the 
hours thicker than the 
ones for the minutes, i % 
30 returns 0 only if i is 
_divisible by 30. 


rectangle.Height = 15; 

rectangle.Fill = new SolidColorBrush(Colors.Black); 
rectangle.RenderTransformOrigin = new Point(0.5 , 0.5); 


TransformGroup transforms = new TransformGroup(); 
transforms.Children.Add(new TranslateTransform() { Y = -140 }) ; 

transforms.Children.Add(new RotateTransform() { Angle = i }); 

rectangle.RenderTransform = transforms; 
baseGrid.Children.Add(rectangle); 

} 

} 

// ... the button event handlers stay the same 


You used a Binding object to set up data 
binding in C# code back in Chapter 11- 
Can you figure out how to remove the 
XAML to create the Rectangle controls for 
the hour and minute hands and replace it 
with C# code to do the same thing? 


Controls like Grid, StackPanel, and 
Canvas have a Children collection with 
references to all of the other controls 
contained inside them. You can add 
controls to the grid with its Add () method, 
and remove all controls by calling its 
Clear () method. You add transforms to a 
_TransformGroup the same way._ 




Flip ba^k *fco *tlic XAML (or the 
houir a^d hands. This Code 

sets up -the same iirahs-Pov-rw, 

ocdcpt ms-tcad b'md'rn^ 七 he 
pvopc\rty it sets it to a value- 
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THANKS 

us BVBErrHiMd we need 

FOR OUR HOVJ VJB 

Cfkbi COrAPBJB FOR THE 
PEBSTI&I^US ^BJBCTVIUUB 
TE^PHY. 


Now -that you added 七 he 
r^av-kmjs -to "the s-topy/a-fcdh, *thc 
\rc-f v/ill rwakc dll *thc \rijh*t Cd\\s. 


又 ill 


㈧ WA tcawVill dow'ma-bc 
七 he £.oy\*fcv-cy>£>c ay\d 
栋 c Objc 如 lie Tvo^y? 
(s/obodYs suve. AH ^ k ^ 0Y/ 
is Joe, Bob, ay\d Ed 
Will Idc bc-btmj oti i*t. 


you are here ► 
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lively and animated 


C # caw build "real" animations, too 


In the G# and XAML world, animation can refer to any property 
that changes over a specific time period. But in the real world, it 
means drawings that move and change. So let’s build a simple 



program to do some “real” animation. 



Create a project and add the pictures 




卜 dh o-f these ahimated bees is a sihale 
厂 e ahirnatioh that’s slightly 

the ohc bcW ahd 

, sho ' 七一 n u •■匕 kl y •… ov-dev- ahd 

幼仏⑶ # Z , #?, 料 , ahd 

h> *Z av^d #Z), it will look 
_ts llappmg its y/ih0s. 



Let’s get started with the project. Create a new 
Windows Store project called AnimatedBee. 

Download the four images (they’re .png files) from the 
Head First Labs website. Then add each one to the 
Assets folder. You’ll also need to create View, Model, 
and ViewModel folders. 


Downloact tke images for tkis ckapter 
from tke Head First LaLs website: 
ww.lieactlirstlaLs.coiii/Looks/ 


kfeskarp/ 






Keep an open mind about animation. 


Watch carefully when you bring up the Windows 
Start page, open an About window, hover over a 
button, or do any number of things in Windows 
apps. Animations are everywhere, and once you 
start looking for them, you’ll keep seeing them. 
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Create a user control to animate a picture 


Let’s encapsulate all of the frame-by-frame animation code. Add a user control called 
Animatedlmage to your View folder. It has very little XAML — all of the intelligence is in 
the code-behind. Here’s everything inside the <UserControl> tag in the XAML: 

<Grid> 

<Image x : Name="image" Stretch= n Fill"/> 

</Grid> 

The work is done in the code-behind. Notice its overloaded constructor that calls the StartAnimation () method, 
which creates storyboard and key frame animation objects to animate the Source property of the Image 
control. 

using Windows.UI•Xaml.Media.Animation; 
using Windows.UI•Xaml.Media.Imaging; 

public sealed partial class Animatedlmage : UserControl 
public Animatedlmage() { 

this. 工 nitializeComponent(); 


B itmap I may is m 七 he 

S*tov^board and 。七 hev 

classes avc 

*m MtA\di hy\^hoY\ 


public Animatedlmage ( 工 Enumerable<string> imageNames, TimeSpan interval) 
: this () 

{ 

StartAnimation(imageNames, interval); 


Every control must have a parameterless constructor if 
you want to create an instance of the control using XAML 
You can still add overloaded constructors, but that’s only 
useful if you’re writing code to create the control. 


public void StartAnimation (工 Enumerable<string> imageNames, TimeSpan interval) { 

Storyboard storyboard = new Storyboard(); 

ObjectAnimationUsingKeyFrames animation = new ObjectAnimationUsingKeyFrames(); 
Storyboard•SetTarget(animation, image); 

Storyboard•SetTargetProperty(animation, "Source"); < 

TimeSpan currentlnterval = TimeSpan.FromMilliseconds(0); 
foreach (string imageName in imageNames) { 

ObjectKeyFrame keyFrame = new DiscreteObjectKeyFrame(); 
keyFrame.Value = CreatelmageFromAssets(imageName); 
keyFrame.KeyTime = currentlnterval; 
animation.KeyFrames.Add(keyFrame); 
currentlnterval = currentlnterval•Add(interval); 


The static 
SetTarget () and 
SetTargetProperty() 
methods from the 
Storyboard class set 
the target object being 
animated ("image") and 
the property that will 
change ("Source"). 


storyboard.RepeatBehavior = RepeatBehavior.Forever; 
storyboard.AutoReverse = true; 
storyboard.Children.Add(animation); 
storyboard.Begin(); < 


Once the storyboard object is set up and animations 
have been added to its Children collection, call its 
_Begin () method to start the animation._ 


private static Bitmaplmage CreatelmageFromAssets (string imageFilename) { 

return new Bitmaplmage(new Uri( M ms-appx : ///Assets/" + imageFilename)); 


you are here ► 
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bees gotta fly 

Make your bees fly around a page 

Let’s take your Animatedlmage control out for a test flight. 


參 


Do tt 



O I25PUA65 MAINPA^B.XAMU WITH A BASIC. PA^B IN TH5 VIEW F^UDBE. 

Add a Basic Page to your View folder called FlyingBees.xaml. Delete MainPage.xaml from the project. 
Then modify App.xaml.cs to navigate to your new page on startup: 

if (! rootFrame .Navigate (typeof (View. FlyingBees) , args . Arguments)) 


❺ 


TH5 B55S WILL FUY ABOUND A CANVAS 

First, change the AppName static resource to Flying Bees. Then add an xml ns property to the 
new page’s〈common : LayoutAwarePage> tag to let it access the View namespace: 


xmlns : view= M using : AnimatedBee.View"^~~ 


Unload 3r\d v-cload -the p\rojcdi i-f -this doesr /七 Compile. 
I*P you used a make suv-e you use 

七 he CoYYtd ms-tcad o-P A^i^a-tcdBcc- 


Next, add a Canvas control to FlyingBees.xaml. A Canvas control is a container, so it can contain 
other controls like a Grid or StackPanel. The difference is that a Canvas lets you set the coordinates 
of the controls using the Canvas . Left and Canvas . Top properties. You used a Canvas back in 
Chapter 1 to create the play area for Save the Humans. Here’s the XAML to add to FlyingBees.xaml.. 


<Canvas Grid.Row="1" Background= M SkyBlue" Width="600" 

HorizontalAlignment="Left" Margin= n 120,0,120,120"> 

<view:Animatedlmage Canvas.Left= M 55" Canvas.Top= M 40 M 

x : Name= M firstBee" Width="50 n Height= M 50"/> 
<view:Animatedlmage Canvas.Left= M 80" Canvas.Top= M 260" 

x : Name= M secondBee" Width="200" Height="200" / > 
<view:Animatedlmage Canvas.Left= M 230" Canvas.Top="100" 

x : Name= M thirdBee" Width="300" Height="125 M /> 

</Canvas> 
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© ADD TH5 6^>D5-B5HIND TH5 PA^B. 

You’ll need this using statement for the namespace that contains Storyboard and DoubleAnimation: 
using Windows.UI•Xaml.Media.Animation; 

Now you can modify the constructor in FlyingBees.xaml.es to start up the bee animation. Let’s also 
create a DoubleAnimation to animate the Canvas . Left property. Compare the code for creating a 
storyboard and animation to the XAML code with 〈 DoubleAnimation 〉 earlier in the chapter. 

public FlyingBees() { 

this. 工 nitializeComponent(); 


List<string> ( ); 

The Cvca-tcFv-arwc 1 ) mcihod 

1 •png"); ^ — 、 

、 takes a o( asset 

2 •png"); 

and a TirwcSpa^ -to set 七 he v-a-tc 

3 •png"); 

七 he -Pva^cs av-c updated- 

4 .png"); 



|r\s*tcad C^f us'm^ 
a <S*tovyboav-di> 
av>d a 

<PoublcA> r ' ,w '3 , t , or\> 


like cav-l'icv- m 
i\\t diiaftcv-, you 
cav\ tveate 


S-tovyboav-d Bv\d 

Poubl 

objct*U and sc*t 
tliciv- pvopev-tics 
•m todc* 



firstBee.StartAnimation(imageNames, TimeSpan.FromMilliseconds(50)); 
secondBee.StartAnimation(imageNames, TimeSpan.FromMilliseconds(10)); 
thirdBee.StartAnimation(imageNames, TimeSpan.FromMilliseconds(100)); 


Storyboard storyboard = new Storyboard(); 

DoubleAnimation animation = new DoubleAnimation(); 
Storyboard•SetTarget(animation, firstBee); 

Storyboard.SetTargetProperty(animation, "(Canvas.Left)"); 
animation.From = 50; 
animation.To = 4 50; 

animation.Duration = TimeSpan.FromSeconds(3); 
animation.RepeatBehavior = RepeatBehavior.Forever; 
animation.AutoReverse = true; 
storyboard.Children.Add(animation); 
storyboard.Begin(); 


The Storyboard 
is garbage- 
collected after 
the animation 
completes. You 
can see this for 
yourself by using 
Make Object ID| to 
watch it and 
clicking O to 
refresh it after the 
animation ends. 


Run your program. Now you can see three bees flapping 
their wings. You gave them different intervals, so they flap at 
different rates because their timers are waiting for different 
timespans before changing frames. The top bee has its Canvas. 
Left property animated from 50 to 450 and back, which causes 
it to move around the page. Take a close look at the properties 
that are set on the DoubleAnimation object and compare 
them to the XAML properties you used earlier in the chapter. 



Something’s not right about this project. Can you spot it? 


you are here ► 
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remember, mvvm is a pattern 


Something’s not right: there’s nothing in your 
Model or ViewModel folder，and you’re creating 
dummy data in the View. That’s not MVVM! 

If we wanted to add more bees, we’d have to create more controls 
in the View and then initialize them individually. What if we want 
different sizes or kinds of bees? Or other things to be animated? If 
we had a Model that was optimized for data, it would be a lot easier. 
How can we make this project follow the MWM pattern? 






THIS IS EASY. JUST ADD AM 

o? and bimd 

THB 6HIUDR5M PROPERTY O? TNB 6ANVAS JO IT. VOHY 
ARB YOU MAKING SU6H A DBAU ABOUT IT? 


That won't work. Data binding doesn’t work with 
container controls’ Children property — and for 
good reason. 

Data binding is built to work with attached properties, which are 
the properties that show up in the XAML code. The Canvas object 
does have a public Children property, but if you try to set it using 
XAML (Children:" {Binding ...}，，）your code zvon } t compile. 

However, you already know how to bind a collection of objects to a 
XAML control, because you did that with ListView and GridView 
controls using the I terns Source property. We can take advantage 
of that data binding to add child controls to a Canvas. 
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Use ItcmsPawcITcmplatG to bind controls to a Canvas 

When you used the 工 terns Source property to bind items to a ListView, GridView, or ListBox it didn’t 
matter which one you were binding to, because the 工 terns Source property always worked the same way. 
If you were going to build three classes that had exactly the same behavior, you would put that behavior 
in a base class and have the three classes extend it, right? Well, the Microsoft team did exactly the same 
thing when they built the selector controls. The ListView, GridView, and ListBox all extend a class called 
Selector, which is a subclass of the ItemsControl class that displays a collection of items. 



We’re going to use its 工 terns Panel property to set up a template for 
the panel that controls the layout of the items. Start by adding the 

ViewModel namespace to FlyingBees.xaml\ 

xmlns : viewmodel= n using : AnimatedBee.ViewModel" 


l-P you used a 


-to the 


❺ 


❺ 


Next, add an empty class called BeeViewModel to your ViewModel folder, 


and then add an instance of that class as a static resource to FlyingBees.xaml\ 
<viewmodel : BeeViewModel x : Key= M viewModel" / > 

Edit FlyingBees. xaml. cs and delete all the additional code that you added to the 
FlyingBees () constructor in the FlyingBees control. Make sure that you 
don^t delete the InitializeComponents () method! 


Here’s the XAML for the I temsControl. Open FlyingBees. xaml, delete the 
<Canvas> tag you added, and replace it with this ItemsControl: 



\/icy/Modcl vcsouvdc as 

data 

bmd |*tcms£ouvtc 


■to a pvopcvty caWtd 
Spvi 七 es. 


/ 


<1temsControl DataContext= n {StaticResource viewModel} n 
Iterns Source= n {Binding Path=Sprites} n 
Grid.Row= n l n Margin= n 120,0,120,120▼▼> 

<1temsControl.ItemsPanel> 

<IternsPanelTemplate> ^ - 

― ^ <Canvas Background: n SkyBlue n /> 
</ItemsPanelTemplate> 


You can set up the 
panel however you 
want. We’ll use a 
Canvas with a sky 
blue background. 


Use the Items Panel 
property to set up an 
I terns Panel Temp late. This 
contains a single Panel 
control, and both Grid and 
Canvas extend the Panel 
class. Any items bound to 
I terns Source will be added 
to the Panel’s Children. 


</ItemsControl.ItemsPanel> 


</ItemsControl> 


When the ItemsControl is created, it creates 
a Panel to hold all of its items and uses the 
I terns Pane ITemplate as the control template. 


you are here ► 
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bee factory 



Create a new class in the View folder 
called BeeHelper. Make sure it’s a static class, 
because it’ll only have static methods to help your 
ViewModel manage its bees. 

using Windows•UI•Xaml•Controls; 
using Windows•UI•Xaml.Media.Animation; 

static class BeeHelper { 


TKc -fattov'Y method patt 饮妁 

MVVM is just oYit ma^Y dcsi^ O^t 

o-f "t^C most Common 一 most usdul — f 3*t*tcv-ir>s is 

如 ^adbov-y ^th\od M 七七 >w(icvc you ^avc a 
^at{x>yy ，1 method Hat ertaits objects. The 
method is usually statid, a^d i\\t ^amc JcitY\ tv\ds 
^\i\, Tadtovy' so \{!s obvious y/Ws ^o\y ^ 。二 


/ 
This -fad-tov-y 
method dreates 
Bcc doirrbroU. I 七 
makes stY\st *to 
keef this m the 
because it’s 
all U|-v-cla*tcd 
todc 


public static Animatedlmage BeeFactory ( 

double width, double height , TimeSpan flaplnterval) 
List<string> imageNames = new List<string>(); 
imageNames.Add("Bee animation 1.png"); 
imageNames.Add("Bee animation 2.png"); 
imageNames.Add("Bee animation 3.png"); 
imageNames.Add("Bee animation 4.png"); 


Animatedlmage bee = new Animatedlmage(imageNames, flaplnterval); 
bee.Width = width; 
bee.Height = height; 
return bee; 


When you take a small block of code that’s reused a lot and put 
it in its own (often static) method, it’s sometimes called a helper 
method. Putting helper methods in a static class with a name that 
ends with “Helper” makes your code easier to read. 


public static void SetBeeLocation (Animatedlmage bee, double x, double y) { 

Canvas.SetLeft(bee, x); 

Canvas•SetTop (bee, y); 

} 

public static void MakeBeeMove (Animatedlmage bee, 

double fromX, double toX, double y) { 

Canvas•SetTop(bee, y); 

Storyboard storyboard = new Storyboard(); 

DoubleAnimation animation = new DoubleAnimation(); 

Storyboard•SetTarget(animation, bee); 

Storyboard•SetTargetProperty(animation, "(Canvas•Left) n ); 
animation.From 二 fromX; 
animation.To = toX; 

animation.Duration = TimeSpan.FromSeconds(3); 
animation.RepeatBehavior = RepeatBehavior.Forever; 
animation.AutoReverse = true; 
storyboard.Children.Add(animation) 
storyboard.Begin(); 


This is same CoAt 
■that was \ y \ the fay’s 

匕 o 灼 st\ru 匕 *to\r Nov/ its m 

a statid hclpcv method- 
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This will dome 
m hahdy ih 
the last lab. 



All XAML controls inherit from the uiElement base class in the windows. ui. Xaml namespace. We 
explicitly used the namespace (windows.ui.Xaml.uiElement) in the body of the class instead of 
adding a using statement to limit the amount of Ul-related code we added to the ViewModel. 

We used uiElement because it’s the most abstract class that all of the sprites extend. For some 
projects, a subclass like FrameworkElement may be more appropriate, because that’s where many 
_properties are defined, including width, Height, Opacity, HorizontalAlignment, etc._ 


❺ Here’s the code for the empty BeeViewModel class that you 
added to the ViewModel folder. By moving the Ul-specific code 
to the View, we can keep the code in the ViewModel simple 
and specific to managing bee-related logic. 

using View; 

using System.Collections.ObjectModel; 
using System.Collections.Specialized; 

class BeeViewModel { 、 


lA/he 的 "the … 七 edlinage dorrbrol is sdded 'to 

the __sp\ritcs Obscv-vablcCollcdiioh that’s bound 
b> the |-tcrwsCo^-t\rol ； s (-tcrwsSoulrdc pvopcvty ； 
the do^iv-ol is added io the item panel, y/hidh 
is dirca-tcd based ov\ -the I 七 erwspa ⑽ Umplate. 




private readonly ObservableCollection<. UI. Xaml. UIElement> 

—sprites = new ObservableCollection<Windows•UI•Xaml•UiElement 〉（）； 

public 工 NotifyCollectionChanged Sprites { get { return sprites; } } 


A sprite is 
the term for 
any 2D image 
or animation 
that gets 
incorporated 
into a larger 
game or 
animation. 


public BeeViewModel() { 

Animatedlmage firstBee = 

BeeHelper.BeeFactory(50 f 50, 

TimeSpan.FromMilliseconds(50)); 
sprites.Add(firstBee); 


Animatedlmage secondBee = 

BeeHelper.BeeFactory(200 
_sprites.Add(secondBee); 

Animatedlmage thirdBee = 

BeeHelper.BeeFactory(300 
sprites.Add(thirdBee); 


WcVc *bwo steps *to c^dafsula*t< 

Spv-i*tcs pv-ofcv-*ty. The badk'm^ -field 
is marked v-cado^ly so i*t tBv\ -t be 

ovcv-y/v-rt*tc^ d 灼 d 如亡 

i*k 3s by\ INo*ti-fyCollcd-tio^Cha^jcd 

pv-opev-ty so othev classes o^ly 
obscv-vc i*t but 灼 。七 modi-fy it 


200, TimeSpan.FromMilliseconds(10)) 


125, TimeSpan.FromMilliseconds(100)); 


BeeHelper.MakeBeeMove(firstBee, 50 
BeeHelper.SetBeeLocation(secondBee 


450, 40) 
80, 260) 


BeeHelper.SetBeeLocation(thirdBee, 230, 100) 


You’re changing properties 
and adding animations on the 
controls after they were added 

to the ObservableCollection- 

Why does that work? 


o 


V 


Run your app. It should look exactly the 
same as before, but now the behavior is 
split across the layers, with Ul-specific 
code in the View and code that deals 
with bees and moving in the ViewModel. 


Tlie \rcadohly keyword 

usc ch ^f sulatioh is ^ 

l 4 广 o 败 A OWh The … doh | 

ohly^modi+icd m its dcdlavatioh ov * ,l * 1 * ^ 


ih the dohs*tvud*tov 





stars and stripes 



ton% B%m\^ 


This is the last exercise in the book. Your job is to build a program that animates bees and stars. 
There’s a lot of code to write, but you're up to the task...and once you have this working, you’ll 
have all the tools you need to build a complete video game. (Can you guess what’s in Lab #3?) 
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The m siep 午 Compile ur>-til you add -the PlayA^aSiic property "to 七 he 
l/icw/VIodd m sicp % /ou use Ihc IDE b> a pv-ofcv-ly siub U \i (or r>ow. 

ADD ^D5-B5HIND F^>12 TH5 PA^B AND 丁 H5 APP. i 

Add the SizeChanged event handler to BeesOnAStarryNight.xaml.es in the View folder: 

private void SizeChangedHandler(object sender, SizeChangedEventArgs e) { 
viewModel.PlayAreaSize = new Size(e.NewSize.Width, e.NewSize.Height); 

} 

Then modify App.xamlcs to change the call to rootFrame . Navigate () so the app starts on your new page 
if (! rootFrame .Navigate (typeof (View.BeesOnAStarryNight) ，- args .Arguments)) 



O ADD TH5 An 工 MATet>lM 紗 e COUl^Ol, lO TH5 VIEW F^>UD512. 

Go back to the View folder and add the Animate dimage control. This is exactly the 
same control from earlier in the chapter. Make sure you add the image files for the 
animation frames to the Assets folder. 


O ADD A US512 6AUL5D lO TH5 VIEW 

This control draws a star. It also has two storyboards, one to fade in and one to fade out. Add 
methods called Fade In () and FadeOut () to the code-behind to trigger the storyboards. 


A Polygon control uses a set of 
points to draw a polygon. This 
UserControl uses it to draw a star. 

<UserControl 

// The usual XAML code that the IDE generates is fine, 

// no extra namespaces are needed for this User Control . 
> 



<UserControl.Resources 〉 


〈Storyboard x:Name= n fadeInStoryboard n > 

<DoubleAnimation From="0" To= M 1" Storyboard.TargetName= M starPolygon" 

Storyboard.TargetProperty= M Opacity" Duration="0:0:1.5" / > 

</Storyboard> 

〈Storyboard x:Name="fadeOutStoryboard"> 

<DoubleAnimation From= M 1" To="0" Storyboard.TargetName="starPolygon" 

Storyboard.TargetProperty= n Opacity" Duration="0:0:1.5" / > 

</Storyboard> 

〈/UserControl • Resources 〉 Youll Y\ttd *to ddd public PddcInO dnd FadcOu*tO 

methods -fco 七 he dode — bdVmd 七 ha 七 s*ta\rt -these 
s-bov-yboav-ds. Thats hov/ -the s-tav-s will (adc 'm out 

<Grid> 


〈Polygon Points="0,75 75, 0 100,100 0,25 150,25" Fill= M Snow" 


Stroke="Black" x : Name= M starPolygon" / > 


</Grid> 

</UserControl 〉 


This polygoh d\rolws the stav-. You 
_ Qh v-cpla^c it with othev- shapes -fco 

with how they wov~k. 


There are even more shapes beyond ellipses, rectangles, and polygons: 
http://msdn.microsoft.com/en-us/library/windows/apps/xaml/hh465055.aspx 


you are here ► 
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oh my stars 



using Windows.UI.Xaml; 
using Windows•UI•Xaml•Controls; 
using Windows•UI•Xaml.Media.Animation; 
using Windows•UI•Xaml.Shapes; 


ADD TH5 SeeS 撤 WeLPeis CLASS TO TH5 VIEW. 

Here’s a useful helper class. It’s got some familiar tools, and a 
couple of new ones. Put it in the View folder. 


static class BeeStarHelper { 

public static Animatedlmage BeeFactory (double width, double height, 
List<string> imageNames = new List<string>(); 
imageNames.Add("Bee animation 1.png"); 
imageNames.Add("Bee animation 2.png"); 
imageNames.Add("Bee animation 3.png"); 
imageNames.Add("Bee animation 4.png"); 


TimeSpan flaplnterval) { 


Animatedlmage bee = new Animatedlmage (imageNames 
bee.Width = width; 
bee.Height = height; 
return bee; 


flaplnterval) 



Canvas has SetLeft () and GetLeft () methods to set and get the X 
position of a control. The SetTop () and GetTop () methods set and get 
the Y position. They work even after a control is added to the Canvas. 


public static void SetCanvasLocation (UIElement control, double x, double y) { 
Canvas•SetLeft(control, x); 

Canvas•SetTop(control, y); 


public static void MoveElementOnCanvas (UIElement uiElement, 
double fromX = Canvas.GetLeft(uiElement); 
double fromY = Canvas.GetTop(uiElement); 


Storyboard storyboard = new Storyboard(); 

DoubleAnimation animationX = CreateDoubleAnimation(uiElement, 

fromX, toX, M (Canvas.Left) M ) 

DoubleAnimation animationY = CreateDoubleAnimation(uiElement, 

fromY, toY, M (Canvas.Top) M ); 

storyboard.Children.Add(animationX); 
storyboard.Children.Add(animationY); 
storyboard.Begin(); 


double toX, double toY) { 

l/Ve added a hdpcv- cs\\tA 
Cv*c3*tcDoub I …七 _ o 灼 0 

七 ha 七 a -thvcc- 

This mc-thod uses | 七七 0 
move d -Pv*orw 

its du\rre 灼七 lodaiio^ -feo a 
new po'mi by its 

Ca^vas.Lc-ft and Canvas. 

Top p\ropc\r-tics. 


public static DoubleAnimation CreateDoubleAnimation (UiElement uiElement, ::.’ 

double from, double to, string propertyToAnimate) 
DoubleAnimation animation = new DoubleAnimation(); 

Storyboard.SetTarget(animation, uiElement); 

Storyboard.SetTargetProperty(animation, propertyToAnimate); 
animation.From = from; 


animation.To = to; 

animation.Duration = TimeSpan.FromSeconds(3); 
return animation; 

} 

public static void SendToBack (StarControl newStar) 
Canvas•SetZIndex(newStar, -1000); 


“Z Index” means the order 
the controls are layered on a 
panel. A control with a higher 
Z index is drawn on top of 
one with a lower Z index. 
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O ADD TH5 See, Sr^/s, AND BvbntA^S 6UASS5S TO TH5 

Your model needs to keep track of the bees’ positions and sizes, and the stars’ positions, and 
it will fire off events so the ViewModel knows whenever there’s a change to a bee or a star. 

using Windows.Foundation; 
class Bee { 



public Point Location { get; set; } 
public Size Size { get; set; } 

public Rect Position { get { return new Rect(Location, 


public double Width { get { return Position.Width; } } 


public double Height { get { return Position.Height; } 


public Bee (Point location, Size size) { 

Location = location; 

Size = size; 


using Windows.Foundation; 

class BeeMovedEventArgs : EventArgs { 

public Bee BeeThatMoved { get; private set; } 
public double X { get; private set; } 
public double Y { get; private set; } 

public BeeMovedEventArgs(Bee beeThatMoved, double 
BeeThatMoved = beeThatMoved; 


Size); } }_ 

using Windows.Foundation; 

} class Star { 

public Point Location { 
get; set; 

} 

public Star(Point location) { 
Location = location; 


- Or\tt you Vou\r y/o\rk'm^ 

bry a Boolean Ro-tatmg 

pv-opc\rty -to 七 he Stav- dlass ar\d use it 
■fco some o( youv- stav-s slov/ly Spm 

avou^d-_ 

x, double y) { 


X = x; 
Y = y; 


The model will -five events -that use -these 
■to 七 el I the \/icy/Modd happen. 


using Windows.Foundation; 

class StarChangedEventArgs : EventArgs { 

public Star StarThatChanged { get; private set; } 
public bool Removed { get; private set; } 

public StarChangedEventArgs(Star StarThatChanged, bool removed) 
StarThatChanged = StarThatChanged; 


Removed = removed; 


The Rcdi s^brutt has scvcv-al 
ovcirloadcd do^s-tv-ud'toirs, 3hd 
methods -that lei you its 

width, hcijht, s\ 2 j^, aY\d loddiiort 
(ci-thcv as a Pom-t o\r mdividual )< 
y double dooirdmates). 


The Po'm-ts pv-opev-ty oy\ 

■the Polyym is a 

dollcdtio^ o( Pom 七 s*brudts. 


_ •>> 


"PKc Poih 七 SizjC) s*bud.*bs 

Tk —.“daW ^mes P ade ^as several very us^ul sWts. Pomt 

uses >< a^a V double to store a set doordmates S,z^ Kas 

tv/。double too, • 技 “ d also a ^ed.al ^fty 

value. Red sWs Uo coo^aits ^ a^d 

a lUas a lot d u^ul me^ods to UA .ts >/ •槪 

>/ 狀 O-tllCV Rcdts, a^d move. 
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O ADD TH5 BeeSr^M^eu 6UASS TO TH5 M^>D5U. 

We’ve filled in the private fields and a couple of useful methods. Your job is 
to finish building the BeeStarModel class. 

using Windows.Foundation; / 

y Y ou ^ use vcado^ly to dv-catc a do^s-ta^-t s-tv-ud-t value- 

class BeeStarModel { 

public static readonly Size StarSize = new Size (150, 100); 



private readonly Dictionary<Bee, Point> 
private readonly Dictionary<Star, Point> 
private Random random = new Random(); 


public BeeStarModel() { 

playAreaSize = Size.Empty; 


bees = new Dictionary<Bee, Point> (); 

—stars = new Dictionary<Star, Point> (); 

is a value o-f Si^ 払 aVs ^served 
俗 an empty s^. Voull use \i \x> o„ly Ortait 
bees a^a stars ▲ 如 f lay a 代 a is W«d. 


public void Update() { 

MoveOneBee (); 
AddOrRemoveAStar(); 


丁 he i/icwModcl will use a -timev- -feo dal I 
"this Upd^cO nr»C"thod f>e\riodiddlly- 


private static bool RectsOverlap (Rect rl , Rect r2) { 

rl.Intersect (r2); 

if (rl.Width > 0 || rl.Height > 0) c- 

return true; ^^ 

} return false; PlayAveaSi^ 

public Size PlayAreaSize { ^ ^ P lro P cv "七乂 

// Add a backing field, and have the set accessor call CreateBees() and GresteStsrs() 


This method thedks -two 
s*tv*ud"ts v*ctu\rr>s *t\ruc i-f "they 
ovcv-lap cath o-thev- usmg 七 |^ 
Rett I) wthod. 


private 

// 

// 

// 

} 

private 

// 

// 

// 

} 

private 

// 

// 

} 

private 

// 

// 

// 


void CreateBees() { 

If the play area is empty, return. If there are already bees, move each of them 
Otherwise, create between 5 and 15 randomly sized bee (40 to 150 pixels) r add 
it to the bees collection, and fire the BeeMoved event. 


void CreateStars() { 

If the play area is empty, return• If there are already stars, 
set each Star’s location to a new point and fire the StarChanged 
event, otherwise call CreateAStar() between 5 and 10 times. 

void CreateAStar() { 

Find a new non-overlapping point, add a new Star object to the 
stars collection r and fire the StarChanged event. 


I-P 七 he r^rthod’s ivied 
1,000 va^dorw loda^lio^s 
3^d haSjr /七 -Pou^d OY\C 
that doesh^t overlap, -the 
play avea has pv-obably 
iruh out o( so jus 七 

v-rtuv-^ a^y pom 七 . 


Point FindNonOverlappingPoint (Size size) { 

Find the upper left-hand corner of a rectangle that doesn't overlap any bees or stars 
You 'll need to try random Rects, then use LINQ queries to find any bees or stars 
that overlap (the RectsOverlap() method will be useful). 


private void MoveOneBee (Bee bee = null ) { 

// If there are no bees, return. If the bee parameter is null, choose a random bee, 

// otherwise use the bee argument Then find a new non-overlapping point, update the bee's 
// location, update the bees collection , then fire the OnBeeMoved event. 

} 

private void AddOrRemoveAStar() { 

// Flip a coin (—random.Next(2) == 0 ) and either create a star using CreateAStar() or 
// remove a star and fire OnStarChanged. Aiivays create a star if there are <= 5, remove 

// one if >= 20• stars.Keys.ToList ()[ random.Next ( stars.Count) ] will find a random star, 


} 

// 


You 'll need to add the BeeMoved and StarChanged events and methods to call them 


// They use the BeeMovedEventArgs and StsrChsngedEventTirgs classes • 


You can debug your app with the simulator to make sure 
it works with different screen sizes and orientations. 
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ADD TH5 BeeSTAisVievjM^eu CUfKSS TO TH5 VI5WMOD5U 

Fill in the commented methods. You’ll need 
to look closely at how the Model works，and 
what the View expects. The helper methods 
will also come in very handy. 


using 

using 

using 

using 

using 

using 

using 


View; 

Model; 

System.Collections.ObjectModel; 

System.Collections.Specialized; 

Windows.Foundation; 

DispatcherTimer = Windows•UI•Xaml.DispatcherTimer; 
UIElement = Windows•UI•Xaml.UIElement; 


We wanted to make sure that 
Dispatcher Timer and UIElement 
are the only classes from the windows. 
ui. Xaml namespace that we used in 
the ViewModel. The using keyword 
lets you use = to declare a single 
member in another namespace. 



class BeeStarViewModel { 

private readonly ObservableCollection<UIElement> 

—sprites = new ObservableCollection<UIElement>(); 
public INotifyCollectionChanged Sprites { get { return —sprites; } } 

private readonly Dictionary<Star, StarControl> 一 stars = new Dictionary<Star, StarControl> (); 
private readonly List<StarControl> —fadedStars = new List<StarControl> (); 

private BeeStarModel 一 model = new BeeStarModel(); 

private readonly Dictionary<Bee, Animatedlmage> 一 bees = new Dictionary<Bee, Animatedlmage>(); 
private DispatcherTimer 一 timer = new DispatcherTimer(); 

public Size PlayAreaSize { /* get and set accessors return and set model. PlayAreaSize */ } 


public BeeStarViewModel () { 

// Hook up the event handlers to the BeeStarModel ' s BeeMoved and StarChanged events, 

// and start the timer ticking every two seconds• 

} 

void timer_Tick (object sender, object e) { 

// Every time the timer ticks, find all StarControl references in the fadedStars 

// collection and remove each of them from sprites, then call the BeeViewModel 's 

// Update() method to tell it to update itself. 

} 

void BeeMovedHandler (object sender, BeeMovedEventArgs e) { 

// The bees dictionary maps Bee objects in the Model to Animatedlmage controls 
// in the view. When a bee is moved^ the BeeViewModel fires its BeeMoved event to 
// tell anyone listening which bee moved and its new location. If the bees 

// dictionary doesn't already con tain an Animatedlmage control for the bee, it needs 

// to create a new one, set its canvas location, and update both —bees and 一 sprites . 

// If the bees dictionary already has it, then we just need to look up the corresponding 
// Animatedlmage control and move it on the canvas to its new location with an animation. 


void StarChangedHandler (object sender, StarChangedEventArgs e) { 

/ / The —stars dictionary works just like the bees one, except that it maps Star objects 
// to their corresponding StarControl controls• The EventArgs contains references to 
// the Star object (which has a Location property) and a boolean to tell you if the star 


/ / was ： removed. If it is then we want it to fade out, so remove it from —stars, add it 
// to fadedStars r and call its FadeOut() method (it 'll be removed from —sprites the next 
// time the Update () method is called, which is why we set the timer^ s tick interval to 
// be greater than the StarControl's fade out animation). 


// 

// If the star is not being removed, then check to see if —stars contains it - if so, get 
// the StarControl reference; if not, you 'll need to create a new StarControl, fade it in r 
// add it to —sprites, and send it to back so the bees can fly in front of it. Then set 
// the canvas location for the StarControl • , , . . • P • 丄 , ^1. 

， seUk _ Canvas UaW, 如 .o^ol is updated^ ^ ,-ts already o, 

如 clvas. TV^is is V^oy/ stav-s move ^cmsclvcs aro^A ^ flay a^a .s ^rcs,. 



you are here ► 
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exercise solution 



§0 办 TTI0H 


Here are the filled-in methods in the BeeStarModel class. 

using Windows.Foundation; 
class BeeStarModel { 

public static readonly Size StarSize = new Size (150, 100) 


private readonly Dictionary<Bee, Point> bees = new Dictionary<Bee, Point>(); 
private readonly Dictionary<Star, Point> 一 stars = new Dictionary<Star, Point> (); 
private Random random = new Random(); 


public BeeStarModel() { 

playAreaSize = Size.Empty; 



public void Update() { 

MoveOneBee(); 
AddOrRemoveAStar(); 




I^Vc gave -these -feo you. 



private static bool RectsOverlap (Rect rl, Rect r2) { 

rl.Intersect (r2); 

if (rl.Width > 0 || rl.Height > 0) 
return true; 
return false; 


Here are the methods for the 
StarControl code-behind: 

public void Fadeln() { 

fadeInStoryboard.Begin(); 

} 

public void FadeOut() { 

fadeOutStoryboard.Begin(); 


private Size _playAreaSize; 
public Size PlayAreaSize { 

get { return playAreaSize; 
set 


playAreaSize = value; 
CreateBees(); 
CreateStars(); 


ihc PlayAreaSize pvopcvty 
-the Model “pdaies 七 he 
__playAreaSize badkmj -field av\d 七 hen dal Is 
CvcaicBccsO av\d Cv-caicStav-sO. This 
lets 七 he UicwModcl Id I iht Model io 
adjus 七 itsd-p 七 he siic 

y/ill happen i-f you 七 he 

on a tablc-t a^d -the ovic^ta-tio^. 


private void CreateBees () { 

if (PlayAreaSize == Size.Empty) return; 


l-f avc 

akeady bees, move 
tscM o+ them. 
/1/lovcO^cBccO 
will -fmd a w/ 
^o^ovcv-lappm^ 
lo^d*bio^ (or cadh 
bcc -f iv-c a 

BccMovcd 


—bees•Keys.ToList(); 
allBees) 


if (—bees•Count() > 0) 

List<Bee> allBees = 
foreach (Bee bee in 
MoveOneBee(bee); 

else { 

int beeCount = 一 random.Next(5, 10); 
for (int i = 0; i < beeCount; i++) 
int s = random.Next(50, 100); 


Size beeSize = new Size (s, s); 

Point newLocation = FindNonOverlappingPoint (beeSize); 

Bee newBee = new Bee(newLocation, beeSize); 

bees[newBee] = new Point(newLocation.X, newLocation.Y); 
OnBeeMoved(newBee, newLocation•X, newLocation.Y); 


l-f theme artY\i any bees m ihc 
rwodel yet, 七 his dveates 
Bee objects ar>d sets -theiv- 
lodatiohs. tirwc a bcc is added 
^ oy y/c heed bo -five a 

BccMovcd cvcht. 


802 Chapter 16 







architecting apps with the mvvm pattern 


private void CreateStars() { 

if (PlayAreaSize == Size.Empty) return; 

if (—stars•Count > 0) { 

foreach (Star star in 一 stars.Keys) { 

star.Location = FindNonOverlappingPoint(StarSize); 
OnStarChanged(star, false); 

} 

} else { 

int starCount = random.Next(5, 10); 
for (int i = 0; i < starCount; i++) 

CreateAStar(); 


1 ( thcv-c avc already s-tavs, 
v/c jus-t set eadh cveistmj 
staves lodatioh {jo a ^cv/ 


pom-t oy \ the PlayAv-ca 
•fiv-c 

It’s up "to the \/icv/Modcl {o 
handle that cvcht a^d move 
"the do\r\rcspohdmg dorrbrol. 


private void CreateAStar() { 

Point newLocation = FindNonOverlappingPoint(StarSize); 


Star newStar = new Star(newLocation); 

_stars[newStar] = new Point(newLocation•X, newLocation.Y); 
OnStarChanged(newStar, false); 


private Point FindNonOverlappingPoint (Size size) { 
Rect newRect; 
bool noOverlap = false; 
int count = 0; 
while (!noOverlap) { 



newRect = new Rect(_random.Next((int)PlayAreaSize.Width 
random.Next((int)PlayAreaSize.Height - 150 ), 
size.Width, size.Height); 


丁 his £.\rcsics a Mhdom R^cdi 
3hd thch dhcdks i-p ovcv^Ups. 
I/Vc gave it a Z^O-pixcl gap oh 

the Hght 3r\d pixel gap oh 

the bottom so "the s-tav-s ahd 

bees doh t leave the play av-ca. 

- 150), 


var overlappingBees = 

from bee in bees.Keys 

where RectsOverlap(bee.Position, newRect) 
select bee; 

var overlappingstars = 

from star in —stars.Keys 
where RectsOverlap( 

new Rect(star.Location•X, star.Locati 
newRect) 
select star; 


)These L|N6^ queries dal I Rc^*b0vcv-lapO 

L -to -P'md a^y bees or stav-s that ovcv-lap 
( r\t^i Red- l-f cithcv* \rc*tu\r^ value has 
\ a the Red ovcv-laps somc-th'mj. 

'n.Y, StarSize•Width, StarSize.Height ), 


if ((overlappingBees.Count() + overlappingStars.Count() 
noOverlap = true; 

} 

return new Point(newRect.X, newRect.Y); 

} 

private void MoveOneBee(Bee bee = null) { 

if (—bees.Keys•Count() == 0) return; 
if (bee == null) { 

int beeCount = 一 stars•Count; 

List<Bee> bees = _bees.Keys.ToList(); 
bee = bees[—random.Next(bees.Count)]; 

} 一 

bee.Location = FindNonOverlappingPoint(bee.Size); 

—bees[bee] = bee.Location; 

OnBeeMoved(bee, bee.Location.X, bee.Location.Y); 


== 0) || (count++ > 1000)) 



|*P 七 his i-tc\ra-tcd 1,000 -times, 
wcVc pvobably ou-t 
of ir>oir>ovc\rlapp*mg spots \y\ 

七 he play a\rca ^ccd -to 

b\reak ou*t o( ^v\ ih-Pmi-tc loop. 


you are here ► 
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exercise solution 



§03tlTT10H 


The last few members of the BeeStarModel class.. 


Flif 3 Co\y\ by dhoos'm^ erthev* O ov* I a-t 
ramdo 你 ， bui always drcaic a stav i-f ihcv-c 

3V"C UK>dc\r ^ 扣 d \rerwo\/e _*P or move. 


(stars.Count <= 5)) && ( stars.Count < 20 )) 


private void AddOrRemoveAStar() { 

if ((( 一 random•Next(2) == 0) | 

CreateAStar(); 
else { 

Star starToRemove = _stars.Keys.ToList()[—random•Next(—stars•Count)]; 
_stars.Remove(starToRemove); 

OnStarChanged(starToRemove, true); 


Bvcvy tirwc the UpdatcO method is dal led, 
v/c wah*t -to ci-thcir add o\r verwove a stav-. The 
} Cv-ca-tcAStav-0 method already dirca-tcs s-tav-s. 

public event EventHandler<BeeMovedEventArgs> BeeMoved; r：；i;，c，，,: lc 3 WC jus*t V"CrwoVC i"t 

TV-orn —stavs a^d -riv-c a cvcr>t 

private void OnBeeMoved (Bee beeThatMoved, double x, double y) 



EventHandler<BeeMovedEventArgs> beeMoved 
if (beeMoved != null) 


BeeMoved; 


beeMoved(this, new BeeMovedEventArgs(beeThatMoved, x, y)); 


public event EventHandler<StarChangedEventArgs> StarChanged; 

private void OnStarChanged (Star starThatChanged, bool removed) 

{ 

EventHandler<StarChangedEventArgs> starChanged = StarChanged; 
if (starChanged != null) 

{ 

starChanged(this, new StarChangedEventArgs(starThatChanged, 



Here are the filled-in methods of the BeeStarViewModel class. 

using View; 
using Model; 

using System.Collections.ObjectModel; 
using System.Collections.Specialized; 
using Windows.Foundation; 

using DispatcherTimer = Windows.UI.Xaml.DispatcherTimer; 
using UIElement = Windows•UI•Xaml•UIElement; 

class BeeStarViewModel { 

private readonly ObservableCollection<UIElement> 

—sprites = new ObservableCollection<UIElement>(); 
public INotifyCollectionChanged Sprites { get { return sprites; 

private readonly Dictionary<Star, StarControl> 一 stars = new Dictionary<Star, StarControl>(); 
private readonly List<StarControl> —fadedStars = new List<StarControl>(); 

private BeeStarModel 一 model = new BeeStarModel(); 

private readonly Dictionary<Bee, Animatedlmage> —bees 

=new Dictionary<Bee, Animatedlmage>(); 

private DispatcherTimer timer = new DispatcherTimer(); 
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|-f you vc do^e d ^ood job with scfav-a*tio^ 
o( 乙 o 灼 dems, youv dcsi^s o-f*tc^ *tc^d *to - 
^atuv-ally c^d up bc'mj loosely ^ouflcd- 




public Size PlayAreaSize { 

get { return —model•PlayAreaSize; 
set { model.PlayAreaSize = value; 


public BeeStarViewModel() { 

_model.BeeMoved += BeeMovedHandler; 

_model.StarChanged += StarChangedHandler; 

_timer • 工 nterval = TimeSpan.FromSeconds(2); 
_timer.Tick += timer 一 Tick; 
timer.Start(); 


void timer_Tick (object sender, object e) 
foreach (StarControl starControl in 
_sprites.Remove(starControl); 

model.Update(); 


fadedStars) 


The ViewModel’s PlayAreaSize property 
just passes through to the property on the 
Model — but the Model’s PlayAreaSize set 
accessor calls methods that fire BeeMoved 
and StarChanged events. So when the screen 
resolution changes: 1) the Canvas fires its 
SizeChanged event, which 2) updates the 
ViewModel’s PlayAreaSize property, which 
3) updates the Model’s property, which 4) calls 
methods to update bees and stars, which 5) fire 
BeeMoved and StarChanged events, which 6) 
trigger the ViewModel’s event handlers, which 7) 
update the Sprites collection, which 8) updates 
the controls on the Canvas. This is an example of 
loose coupling, where there’s no single, central 
object to coordinate things. This is a very stable 
way to build software because each object 
doesn’t need to have explicit knowledge of how 
the other objects work. It just needs to know one 
small job: handle an event, fire an event, call a 
_method, set a property, etc._ 


void BeeMovedHandler (object sender, BeeMovedEventArgs e) { 
if (!_bees.ContainsKey(e.BeeThatMoved)) { 

Animatedlmage beeControl = BeeStarHelper.BeeFactory( 

e.BeeThatMoved.Width, e.BeeThatMoved.Height, TimeSpan.FromMiHiseconds(20)); 
BeeStarHelper.SetCanvasLocation(beeControl, e.X, e.Y); 

bees[e.BeeThatMoved] = beeControl; 

_sprites.Add(beeControl); 

} else { 

Animatedlmage beeControl = bees[e.BeeThatMoved]; 

BeeStarHelper.MoveElementOnCanvas(beeControl, e.X, e.Y); 


void StarChangedHandler (object sender, StarChangedEventArgs e) { 
if (e.Removed) { 

StarControl starControl = —stars[e.StarThatChanged]; 
_stars.Remove(e.StarThatChanged); 

_fadedStars.Add(starControl); / 

starControl.FadeOut (); 、 

} else { 

StarControl newStar; 

if (—stars•ContainsKey(e.StarThatChanged)) 
newStar = _stars[e.StarThatChanged]; 
else { 

newStar = new StarControl(); 

_stars[e.StarThatChanged] = newStar; 
newStar.Fadeln(); 

BeeStarHelper.SendToBack(newStar); 
sprites.Add(newStar); 


The __fadcdS-ta\rs dollcdtio^ do^*ta'ms 

•the do^*t\rols that du\r\rc^*tly -fadmj 
aY\d will be v-emoved the 的 wt time the 
ViewModel’s IXfda*teO method is called- 



BeeStarHelper.SetCanvasLocation ( 

newStar, e.StarThatChanged.Location.X, 

l*f d is bem 》 added, rt r^ccds -fco have i-ts Fadcl^O 
w 七 hod tailed, if ii's already ii's just bei^ 

你 ov/ed because -the play a\rca siz^ Ranged. Biihcv way, 
we wair>*t -to move ii io its new lodaiio^ ov\ ihc Canvas. 


e.StarThatChanged.Location.Y); 


you are here ► 
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you’re a c# pro 

Congratulations! (Put you're wot done yet...) 

Did you finish that last exercise? Did you understand everything that was going on? If 
so, then congratulations — you’ve learned a whole lot of G#, and probably in less time 
than you’d expected! The world of programming awaits you. 

Still, there are a few things that you should do before you move on to the last lab, if you 
really want to make sure all the information you put in your brain stays there. 



Take one last look through Save the Humans. 

If you did everything we asked you to do, you’ve built Save the Humans 
twice, once at the beginning of the book and again before you started 
Chapter 10. Even the second time around, there were parts of it that 
seemed like magic. But when it comes to programming, there is no 
magic. So take one last pass through the code that you built. You’ll 
be surprised at how much you understand! There’s almost nothing 
that seals a lesson into your brain like positive reinforcement. 


Wken it 


comes to 
programming^ 
tkere is no 



Talk about it with your friends. 


Humans are social animals, and when you 
talk through things you’ve learned with your 
social circle you do a better job of retaining 
them. And these days, “talking” means 
social networking, too! Plus, you’ve really 
accomplished something here. Go ahead 
and claim your bragging rights! 


magic. Every 
rogram works 
3ecause it 
was tuilt to 
work，anct all 

code can l>e \ 

uncterstooct. 


Take a break. Even better, take a nap. 

Your brain has absorbed a lot of information, and 
sometimes the best thing you can do to “lock in” all 
that new knowledge is to sleep on it. There’s a lot of 
neuroscience research that shows that information 
absorption is significantly improved after a good 
night’s sleep. So give your brain a well-deserved 
rest! 



...but its 3 lot 
■to uhdcirstahd todt i-f 
the p\ro0\rdrMrMe\r used 
good design paltcv-hs 
objcdt-o\riCh-tcd 

pirogira 咖 mg pirihdiplcs. 



O 


Tbe 

Jiumans forgot akput us! 
TlmetP attack wJiile they We 
lowered their guard! 
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C#Lab 

Invaders 

This lab gives you a spec that describes a program 
for you to build, using the knowledge you’ve 
gained throughout this book. 

This project is bigger than the ones you’ve seen so 
far. So read the whole thing before you get started, 
and. give yourself a little time. If you did all of the 
exercises throughout the book, you have all of the 
tools that you need to do this lab. 

We’ve filled, in a few design details for you, and. 
we’ve made sure you’ve got all the pieces you 
need...and nothing else. 

It’s up to you to finish the job. You can get our 

version of the finished Invaders game from the 
Windows Store as an open source project, so its 
source code is available...but you’ll have the best 
C# learning experience if you build it all yourself! 

www.headfirstlabs.com/tifcsharp for details. 




C# Lab 807 





The grandfather of video games 

In this lab you’ll pay homage to one of the most popular, revered, 
and replicated icons in video game history, a game that needs no 
further introduction: it’s time to build Invaders\ 


|hvadc\rs is a iVihdows 
S-fcov-c aj>j> a 
single Basid Page. 


TV mvadc^rs attack m >^avcs o-f 11 coW^s 
W\i\\ s»% mvadm. TV ^Wsi >m3vc moves 

slowly and -fiv-cs a sl^o-b a*b a T^c 

於乂 七 y/dve moves -faster, 3r\d -fives move 
sV^o*U move -fv-c<\ucr\*tly- l-f ^ mvadev-s m d 
y/avc av-c des-tv-oyed, 七 wve attacks. 




Invaders 


4 


As "the playcv* dcs-tv-oys -the 
ihvadev-s, the sdov-c ^oes up. 
|"t’s displayed m 七 he uppev-- 
\ri(\lvthaK>d ^ov-hcv-. 


TKc playev- s*tav*b ou 七 >w*rth 
-tKv-cc sliifs. The -f*ivs*t siVlf IS 
•m play, ar>d -the o*tV>cv *t>wo avc 
kef 七 m vesewe- His spav-c sKifs 
avc shovm u^dcv-^ca^ stove- 


2690 



<A> tA ? ⑷ <A> <*> ⑷ <A> <#> 

e %_^KL/' 

/av, /W, /%v 

lk^ 

♦ 

-^vp 

今 + + j ^ ^ f 

+ + + + ' ♦ 
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TKc playcv moves *tKc siiip lc*f*t 
ar\d rijli-t, By\A -fibres shots a 七 

*tKc mvadev-s. l-f d siiot Wrts 扣 
mvadev-, ti^c mvadev is des-tvoyed 
dhd *tKc players stove joes up. 


TKc mvaders 代七冰 “ ,rc . f f 。 

tKe sW, ? , -tKc ? la Y er loses a \\^. Out all Ws ^ 

ao^c, or *,-f tKe mvaders 代 W 

Leer, -tKc 3 ar,c c^ds a^d a k ， 3 OVtR • 

disflayca m -tKc ^.ddlc tKc s^cch. 


The mvadev-s^ ships 
avc a^ima*ked >wi*th 
blodky, fi%cla*tcd, 
Ytbro ^Os—s*tylc 
yafhids. The 
v/hole flay'm^ av-ca 
has a 午 3 asfedi 
vatio just like 

扣 old dv~dddc 

dabmet domflc*tc 
wi*th simulated 
sda^ Imes *to make 
••七 look autherrbd. 



The rwul-ti^olov-cd 

s-tavs \y\ -the 

ba^kj\rouhd tv/mklc 

OY\ 3 K>d o((, but 

don’t a-f-fc^t 
ja^cplay at all. 
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Your mission ： defend the planet RememW, you can Jownloact 

against wave after wave of mvadcrstlte Invaders gfrapkics from 

keactlirstlatsxom/Wcska^ 


The invaders attack in waves, and each wave is a tight formation 
of 66 individual invaders. As the player destroys invaders, his score 
goes up. The bottom two rows of invaders are shaped like stars and 
worth 10 points. The satellites are worth 20, the saucers are worth 
30, the bugs are worth 40, and those pesky alien invader spaceships 
that have been invading Earth since Chapter 1 are worth 50. 

The player starts with three lives. If he loses all three lives or the 
invaders reach the bottom of the screen, the game’s over. 





^ at As soo, as a 
sV^ot tan be ^d. 


TKc y/avc <^f 

mvadev-s 

sKo*b a*t ohtc—*tKc 
mvadevs y/'ill V^old "b^c'iv 
-f jv-c i-f *tKcvc avc wove 
■two sKo*bs oy \ *tV>c 

stv*ccy\- TKc 

-f ives *tWcC) *tKc 

-f ives -fouv*> air\d so on- 


u 




SPAC 



Thc\rc a\rc -five di*ffe\r ⑶七 types o( mvadev-s, 
bui they all behave the same way. They s-tav-t 
"the "top o-p "tlic sd\TCCh ywovc uivtil 
they \rcath the cdjc. Then -they dv-op dowh 
and sta\rt rnov'mj v-ijhi. W\\cy\ ihey v-cadh the 

\rialvtha^d boundary, they d\rof dovm 扣 d 
idi ajaih. 1( ihc ir>vadcv-s -the bo-t 
o-f -the screen, the game’s ovcv-. 


move 
七 ■(jorw 


© 


4 



LEFT 


r _ 

Sy/ipm^ \t^i OV *tKc lc*ft 

w key 州 oves 七 he sWip W'rd 
cdy tKc street. 




l-f d shot hi"ts 

By\ mvadev-, bo*th 
disappeav-. 0 *thcv-y/isc 
■the shot disappears 
y /“伙 i 七 ^rts *to *thc 
*top o-f *thc sdvee^. 


Playevs itv\d io the 
keyboav-d, so the 
keeps ■brad W whi 乩 keys 
^ ^u\nrchtly beih^ held 
dovm. Pircssihg v-ight a^d 
tlieh would d^use 

"the ship -to -fivst move -fco 
the \righ-t ahd thch -fire 

(i*P thlrcc shots 


alv-cady oh the sd\rcch). 





av-vov/ 

七 he 1 


RIGH 


Swipiq Hght ov- usmg the 
浐吵七 av-\row key rwoves the 
ship "to the \right. 
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The architecture of Invaders 


Invaders is an MVVM app. The Model needs to keep track of 
a wave of invaders (including their location, type, and score 
value), the player’s ship, shots that the player and invaders fire 
at each other, and stars in the background. The View uses a 
Basic Page and controls for animated images and stars, as well 
as a static helper class to help the ViewModel. 

Here’s an overview of what you’ll need to create: 


The ma'rn play 
is I'tcrwsCo^'tv'ol 
wi-th a Canvas -Pov- 
ItcmsTcrwplatc av\d *rb 

("tcmsSouv-dc bouir^d b> By\ 
ObscwablcCollcd-tio^ o( 
CorrbroU. 


M 




BINDING 




^cpSg^ 


This app doy>sis*U d a sm^lc Basid Pa^c 七 ha 七 
dor^id'ms av\ |*tcmsCoy>*tv-ol (or *thc flay avea 
v/hev-e 七 he athoY\ a ^ndV'iow *to 

display *thc flaycv-^s sWifs a 1c%*tBlodk 
(or i\)t sdov-c, d Pofuf bo display i\\t About 
bo%, By\A a -fc>w move 1c%*tBlodks a^d bu*t*toy>s 
-to display >whcir> 七 he ^3mc is paused ov* ovcv*. 



t: 




The \/icv/A1odd 


objedi lis-tc^s -to events -Pivcd by 七 he 

/V]odel and uses them -to update -the dollcdtio^ o( CoY\bro\s 
so "the \/icv/ C^y\ b*md b> it li also -fives Pv-opcviyCha^yd 
cvc^"ts *to let "tiic \/icv/ ki^ow v/hcK> "the i^urwbcv* o-r lives 
le*P*t has -the jarwc is paused, ov 七 he game is 


ovcv-. 


You haven't seen a <Popup> control before. 

An important part of programming is figuring out how to use tools that 
you haven’t seen before. We’ve thrown in a new control, the Popup, which 
you’ll use to pop up an About box when the user chooses About from the 
Settings charm. This is a good chance to test your developer skills! 
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ShipChanged event 


CVCh-ts av-c 
(wd whchcvcv- 
thc playcv- ov- 
i^vadcv ships olv-c 
ddded ； moved ； 
ov destroyed- 


All o-f i\\t mvadev-s oy\ tiic s^vccr\ 
av^ s*toved m a Lis*t. IAA^ a” 
m vdde\r is destv-oyed, it's removed 
-f\rom 七 he list 








\e r 0说 & 



ShotMoved event 


The objedi ihai \rcp\rcsc^ts 七 he 

ship keeps i\radk of i-ts position 
and rwoves iiscl-f Ic-P-t av\d vight, 
mak’mg suv-c it doesr /七 move o(( 
"the side o-f -the sdv-cch. 


StarChanged event 










C 


^<Po \^ 7 


The /VJodel manages -the garwcplay. H 
keeps "tva 匕 k of how lives -the pbyev* 
has Ic-f-t dhd how mdy)y waves of mvddev-s 
att^ked. |七 has pv*opc\rtics -to tv\d 
and p^usc "the jdme； a^d cve^-ts -to move 
ships sho*ts and "twinkle s-tavs. 




The Stav-S ob\cdt keeps a List o-f po'm-t 
s-tv-udis, oy\C +ov eddh stav- m 

•the badkyou^d- The l^vadcv-sAlodcl 
object -fiv"cs cvc^*ts *to 

add av\d v-emove stav-s so they look like 

theyVe -tv/mklmj- 


The keeps a 
l*is*t o( Sho 七 objcd*ts, 
•mdludmj sKo*ts *tV>C 
playcv- -fived a*t 七 he 
mvadev-s a^d also 
shots 七 he *mvadcv-s 

-Piv-cd badk. Bach 
time a slio 七 is added, 
moved) ov vemoved, 

七 he l^vadcv-sModcl 
objcd*t -f iv-cs a 
ShotMoved cvcy>*t. 
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Puild out the object model for the Model 

Before you can build out the 工 nvadersModel class, you’ll need the classes that it 
uses to keep track of the gameplay. It’s going to have an object for the player, and 
collections of invaders, shots, and stars. That means it’ll need classes for invaders and 
shots (it’ll use a Point struct for each star, because all it needs to know is the star’s 
location). 


Collision 

disdoveirm^ 
■fcwo rmov'm^ 
spviics have bumped 
ih-to eadh othev-. 

〆 


The Player and Invader classes extend an abstract class called Ship that 
has properties (set in the constructor) to keep track of its location and size. It’s also got 
a convenient property that uses the location and size to create a Rect, which can be 
used for collision detection. You’ll need to implement these two subclasses. 


Ship 

Location: Point 
Size: Size 
Area: Rect 


Here’s the abstract Ship class for the Model folder: 


using Windows.Foundation; 

abstract class Ship { 

public Point Location { get; protected set; 

public Size Size { get; private set; } 

public Rect Area { 

get { return new Rect(Location, Size); } 


public Ship (Point location. Size size) 
Location = location; 

Size = size; 


public abstract void Move(Direction direction); 


The sc*t Btttssor 


-fov LoCBhoY\ is 

so o^ly 
subclasses 

set it 


abstract Move(Direction) 
ctor: Point, Size 



Player 


Invader 

static PlayerSize: Size 

static InvaderSize: Size 
InvaderType: InvaderType 
Score: int 

Move(Direction) 

Move(Direction) 
ctor: InvaderType, Point, 

Size 






The Player moves left and right. 

The Model will call a Player object’s Move () method 
to tell it to move left or right, using a Direction enum 
to tell it which way it’s moving. The Player can’t move off 
the end of the screen. It can use the 工 nvadersModel’s 
static PlayAreaSize property to stop moving when it 
hits the side of the play area. You’ll also need a static read¬ 
only Size for the Player’s size (25 x 15 pixels) and 
const double for its speed (10 pixels per Move () call). 


Invaders move left, right, and down. 

The Invader and Player classes both have a 
Move () method that uses a switch statement to 
determine which way to move. The I nvader class also 
has an additional constructor that takes parameters to 
set its 工 nvader Type and Score properties. These 
properties determine which graphic is displayed on 
the page, and how many points get added to the score 
when the ship is destroyed. 
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using Windows.Foundation; 


class Shot 
public 

public 

public 


const double ShotPixelsPerSecond = 95; 


Point Location { get; private set; } 
static Size ShotSize = new Size (2, 10) 


-You tBy\ speed 
up ov slow dovm 
sho*ts by 

pi^cl speed. 


private Direction —direction; 

public Direction Direction { get; private set; } 

private DateTime _lastMoved; 

public Shot (Point location, Direction direction) { 
Location = location; 

—direction = direction; 
lastMoved = DateTime.Now; 


public void Move() { 

TimeSpan timeSinceLastMoved = DateTime.Now - 一 lastMoved; 
double distance = timeSinceLastMoved.Milliseconds 
* ShotPixelsPerSecond / 1000; 
if (Direction == Direction.Up) distance *= -1; 

Location = new Point(Location•X, Location.Y + distance); 
lastMoved = DateTime.Now; 


using Windows.Foundation; 


class StarChangedEventArgs 


EventArgs 


public Point Point { get; private set; } 
public bool Disappeared { get; private set; } 

public StarChangedEventArgs (Point point, 

bool disappeared) 

Point = point; 

Disappeared = disappeared; 

using Windows.Foundation; 
class ShotMovedEventArgs : EventArgs 



You’ll need this Shot class. 

The Model uses it to keep track of the 
shots that the player fires, and the shots 
the invaders fire back. Have a close look 
at the Move () method: it uses a private 
DateTime field to keep track of the 
last time it moved. Each time Move () is 
called, the shot’s Location is moved 
either up or down at a velocity of 95 
pixels per second. 

You’ll also need these three EventArgs 
classes, which the Model uses to let the 
ViewModel know when stars appear and 
disappear; when shots move, appear, and 
disappear; and when ships move and die. 

When a player or invader fires 
a shot, the Model will create 
a Shot object, and then fire 
a ShotMoved event. The 
ViewModel will handle this 
event and update its Sprites 
collection, which will notify the 
View that it changed. 


public Shot 
public bool 


Shot { get; private set; } 
Disappeared { get; private set; 


public ShotMovedEventArgs (Shot 
Shot = shot; 

Disappeared = disappeared; 


shot, bool disappeared) 


This Chum 
dctcirmihcs 

whi 匕 h type of 

s ^ip Sv\ ihvddev* 
is flvi, 


using Windows.Foundation; 


class ShipChangedEventArgs : EventArgs { 

public Ship ShipUpdated { get; private set; 
public bool Killed { get; private set; } 


enum InvaderType 

Bug, 

Saucer, 

Satellite, 

Spaceship, 

Star, 


public ShipChangedEventArgs (Ship 
ShipUpdated = shipUpdated; 
Killed = killed; 


ShipUpdated, bool killed) { 


Sliifs By\A shots 
use 

*to dc*tcv*m*mc 
y/h*idV> d*iV-Cd*t*ioir> 

-tliCvVc 



enum Direction 
Left, 
Right, 

Up, 

Down, 
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Puildmg the InvadersModel class 

The 工 nvadersModel class controls the Invaders game. 
Here’s a start on what this class should look like — there’s still 
lots of work for you to do. 


using Windows.Foundation; 


class InvadersModel { 

public readonly static Size PlayAreaSize 
public const int MaximumPlayerShots = 3; 
public const int InitialStarCount = 50; 


new Size (400 f 300) 


private readonly Random random = new Random(); 


public int Score { get; private set; } 
public int Wave { get; private set; } 

public int Lives { get; private set; } W\\cy\ the playcv- dies, -the \/icv/Modcl makes 

the f layers ship -Plash (or Z5 seconds. The 

public bool GameOver { get; private set; } ^odd uses a DatcTirwc? -to keep tv-adk o( 

this time -the ships ov shots 

^ rwov'mj y/hilc the playcv is dyir^. 

playerDied.HasValue; } } 


private DateTime? _playerDied 
public bool PlayerDying { get 


null; 
return 


private Player —player; 

private readonly List<Invader> —invaders = new List<Invader>() 
private readonly List<Shot> _playerShots = new List<Shot>(); 
private readonly List<Shot> _invaderShots = new List<Shot>(); 
private readonly List<Point> —stars = new List<Point>(); 

private Direction _invaderDirection = Direction•Left; 
private bool _justMovedDown = false; 

private DateTime _lastUpdated = DateTime.MinValue; 

public 工 nvadersModel () { 

EndGame()/ 

} 

public void EndGame() { 

GameOver = true; 

} 


// You'll need to finish the rest of the InvadersModel class 
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The InvadersModel methods 

The InvadersModel class has five public methods that are used by the 
ViewModel. The EndGame () method is on the facing page — here are the rest 

o THE Sra^A^eQ METHOD STARTS THE &AMB PUAYIN^. 

This method sets the GameOver property to false. Then it clears any invaders from the _ 
invaders collection and shots from the _p layer Shots and _invader Shots collections (but 
before it does, it fires a ShipChanged or ShotMoved event for each of them). Then it clears the 
stars (firing the Star Changed event for each star) and creates new stars. Finally, it creates a new 
Player object (firing a ShipChanged event), sets Lives to 2, Wave to 0, and adds the first wave. 

© THE FuseS^rO METHOD MAKES THE PUAYBR FIRE A SH^T. 

This method checks the number of player shots on screen to make sure there aren’t too many, 
then it adds a new Shot to the —player Shots collection and fires the ShotMoved event. 

O THE M^vePuAYBisO METHOD THIS PUAYBR. 

If the player has already died, this does nothing; otherwise, it calls the Player object’s Move () 
method and then fires the ShipChanged event to let the ViewModel know the ship moved. 

o THE TvuiNKueQ METHOD TWINKUBS THE ST AES. 

This method flips a coin and either adds or removes a star, firing the Star Changed event. There 
are always fewer than 50% more and greater than 15% fewer than the initial number of stars. 

O THE UpoatbO METHOD THIS d&AMB &0. 

The ViewModel uses a timer to call the Update ( ) method many times a second as long as the game 
isn’t over — this is what keeps advancing the gameplay. First it checks to see if the game is paused. If it 
isn’t, here’s what it does (it always twinkles the stars, whether or not the game is paused): 

* If there are no more invaders, it creates the next wave. 

* If the player hasn’t died, it moves each invader (more about this on the next page). 

* Then every shot needs to be updated (unless the player is dead). The game needs to loop 
through both shot collections, calling each shot’s Move ( ) method. If any shot went off the 
edge of the play area, it’s removed from the collection and a ShotMoved event is fired. 

* The invaders return fire (more about this on the next page too). 

* Finally, it checks for collisions: first for any shot that overlaps an invader (and removing both 
from their collections), and then to see if the player’s been shot. This is where that Rect 
property on the Ship base class will come in very handy~you can use the method that checks 
for overlapping Rects from Chapter 16 to detect the collisions (more on the next page). 



Here’s a tip: If you try to remove an object from a collection while you’re enumerating 
though it using foreach, it’ll throw an exception. But you can use the LINQ ToList () 
extension method to make a copy of the collection first and loop through that instead. 
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Filling out the InvadersModel class 

The problem with class diagrams is that they usually leave out any nonpublic 
properties and methods. So even after you’ve got the methods from the previous 
page done, you’ve still got a lot of work to do. Here are some things to think about: 

The game play happens on a 400x500 battlefield 

The first line in the 工 nvadersModel class creates a public Size field called 
PlayAreaSize. It’s static and read-only, which means it can’t change through^^- 


the life of the 工 nvadersModel. This defines the boundaries of the play area for 
all of the Model objects: the shots can use it to determine when they’ve reached the 
top or the bottom of the play area, and the invader and player ships can use it to 
determine when they’ve hit the sides. The objects in the View will typically move 
around a Canvas that’s larger than 400x300, so part of the ViewModel’s job will 
be to scale all of the coordinates up so that they’re moved to the right place. 


"The hcx-fc page may so a 
bit dornplcx v/hch you -fiv-s-fc 
^rcad it, but eadh LINQ 


^C\ry is just a Couple lihcs 
° + ttcv-c S a hih-t ： do^i 

owd— 心七 <! ii. 




I 七、如 \Z\^ModtU job 
-to -t\ray\sla*tc Modt\ s 

too\rd'ma*tcs ov\ a ^OO-AOO 
plav av-ca *to Y/^a*tcvcv- s»« 

Canvas ⑽ be cw 从 c ? 乎 


Puild a NextWaveO method 

A simple method to create the next wave of invaders will come in handy. It should 
increment the Wave property, clear the private —invaders collection, and then 
create all of the Invader objects, giving each of them a Location field with 
the correct coordinates. Try spacing them out so that they’re spaced 1.4 invader 
lengths apart horizontally, and 1.4 invader heights vertically. w 

A few other ideas for private methods IlcSld 

out you\r \/icwA1 odd 

Here are a few of the private method ideas you might play with, to see if these 1 

would also help the design of your Game class: 

* A method to see if the player’s been hit (CheckForPlayerCollisions ()) 


A method to see if any invaders have been hit 
(CheckFor Invader Collisions ()) 

A method to move all the invaders (MoveInvaders ()) 

A method allowing invaders to return fire (ReturnFire () 





It’s possible to show protected and private properties 
and methods in a class diagram, but you’ll rarely see 
that put into practice. Why do you think that is? 


丁 he i^vadev-s move mdividually -fv-om side 
"to side. I/Vhch -they yt bo "the edje 
of ihc battlefield, 七 hey w»ovc dovm. 

A rweihod -to move all mvadev's dalls 
eath invaders MovcO method. H 
use "the 一 l 3 s-tUpd 3 "tcd -f ield "to speed 
“p -the mvadems by vedudmj ihc lime 
bciv/ccK> mashes as -the rtumbev o( 
mv/adevs Ic-P't \v\ "the -Pov-rwa-tio^ shvmks. 
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Invaders 


a^y mvadcv- the cdjc, 

*thc -fo\rma*tio^ *tu\r^s dv^ou^d- 



LINQ makes collision detection much easier 

You’ve got collections of invaders and shots, and you need to search through those 
collections to find certain invaders and shots. Any time you hear collections and search 
in the same sentence, you should think LINQ. Here’s what you need to do: 

O fi^ueb out if the invadbes 7 f^emati^n has ebachbd the bd^b. 

The invaders need to change direction if any one invader is within twice its horizontal move interval from 
the edge of the battlefield. When the invaders are marching to the right, once they reach the righthand side 
of the play area, the game needs to tell them to drop down and start marching to the left. And when the 
invaders are marching to the left, the game needs to check if they’ve reached the left edge. To make this 
happen, add a private Movelnvaders () method that gets called by Update () .The first thing it should 
do is calculate the amount of time since the last movement using the —lastUpdated field, and do nothing 
if not enough time has passed, check and update the private frames Skipped field. If the invaders are 
moving to the right, Movelnvaders () should use LINQ to search the —invaders collection for any 
invader whose location’s X value is within range of the righthand boundary. If it finds any, then it should tell 
the invaders to march downward and then set invaderDirection equal to Direction . Left; if not, 
it can tell each invader to march to the right. On the other hand, if the invaders are moving to the left, then 
it should do the opposite, using another LINQ query to see if the invaders are near the lefthand boundary, 
marching them down and changing direction if they are. It can use the _j ustMovedDown field to keep 
track of when the formation just switched direction and marched down. 

@ teTBEMINB WHI6H INVADBES CAN EBTURN FIEB. 

Add a private method called ReturnFire () that gets called 
by Update () . First, it should return if the invaders’ shot 
list already has wave + 1 shots. It should also return 
if _random. Next (10) < 10 - Wave. (That makes 
the invaders fire at random, and not all the time.) If it gets 
past both tests, it can use LINto group the invaders by 
their Location . X and sort them descending. Once it’s 
got those groups, it can choose a group at random, and use 
its Last () method to find the invader at the bottom of the 
column. All right, now you’ve got the shooter — you can add 
a shot to —invader Shots list just below the middle of the 
invader (use the invader’s Area to find the shot’s location). 

O CHBCK FOE INVADBE AND PUAYBE COUUSIONS^ 

You’ll want to create a method to check for collisions. There are three collisions to check for, and the method to 
find overlapping Rects from Chapter 16 will come in handy. 

* Use LINQ to find any dead invaders by looping through the shots in the player’s shot list and selecting 
any invader where Area contains the shot’s location. Remove the invader and the shot. 

* Add a query to figure out if any invaders reached the bottom of the battlefield — if so, end the game. 

* You don’t need LINQ to look for shots that collided with the player, just a loop and the player’s Area 
property. (Remember, you can’t modify a collection inside a foreach loop. If you do, you’ll 
get an InvalidOperationException with a message that the collection was modified. You may 
need to create a temporary List of objects to remove, or use the ToList () extension method to copy 
it first.) 
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Invaders 



Puild the Invaders page for the View 

The main page for Invaders is a Basic Page that lives in the View 
folder. It has a ViewModel object as a static resource, which is used 
for the DataContext for all of the controls on the page. 



All action is handled with binding. 

The invaders, player ship, shots, stars, and even 
the simulated scan lines are all controls that 
are added to an ObservableCollection 
of controls in the ViewModel. You’ll also 
need a TextBlock with the text “Game 
Over” with its Visibility bound to the 
Game Over property, and another with the 
text “Paused” bound to the Paused property. 


The play area is always resized to 
keep a 4:3 aspect ratio. 

The main play area is a Border with rounded 
corners that contains an 工 terns Control 
with the ItemsPath bound to the Sprites 
property, and whose 工 temsPanel is a Canvas 
with a black background. We’ll give you code on 
the next page that updates its margins to make 
sure it always keeps a 4:3 aspect ratio — it will 
modify the Margin property of the Border 
to keep the Height 4/3 the size of the Width, 
even if the screen is rotated or resized. 


The score and extra lives 
are separate controls. 

There’s a StackPanel in the upper- 
righthand corner with a TextBlock 
bound to the Score property and 
a GridView bound to the Lives 
property. The GridView displays 
ships because its DataTemplate 
is an Image control, so the Lives 
property in the ViewModel needs 
to be a collection of objects — new 
object () — to make the GridView 
add or remove images. 
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Maiwtaiw the play area's aspect ratio 



The code-behind for the main page needs to do two things. It has to handle events when the 
page resizes to maintain the play area’s 4:3 aspect ratio, and it needs to handle both 
keyboard and swipe input. If the player is using a tablet, rotating it will change the play area 
size. So you’ll need to handle a few events in your page root’s XAML code: 

〈common : LayoutAwarePage II tittd "these 

x : Name="pageRoot" events -to ihput, whidh 

... io oh the hext pa^e. 

'using : (the namespace you used) .ViewModel" 


xmlns : viewmodel: 


SizeChanged="pageRoot SizeChanged’ 


Vi 


ManipulationMode="TranslateX" ManipulationDelta="pageRoot_ManipulationDelta M 
ManipulationCompleted="pageRoot ManipulationCompleted" Tapped 二 n pageRoot Tapped' 


> 


and in the Border around the play area: 

<Border x : Name="playArea M BorderBrush= M Blue" BorderThickness= M 2" CornerRadius: 

Background="Black" Margin="5" Grid.Row="1" Loaded:’▼ piayArea—Loaded n > 
<ItemsControl 


10 


Here’s the code-behind that keeps the play area’s 4:3 aspect ratio by adding 
either left and right margins or top and bottom margins. 

private void playArea_Loaded (object sender, RoutedEventArgs e) 
UpdatePlayAreaSize(playArea.RenderSize); 


private void pageRoot 一 SizeChanged (object sender, SizeChangedEventArgs e) 
UpdatePlayAreaSize(new Size(e.NewSize.Width f e.NewSize.Height - 160)) 


private void UpdatePlayAreaSize (Size newPlayAreaSize) { 
double targetWidth; 
double targetHeight; 

if (newPlayAreaSize.Width > newPlayAreaSize.Height) { 

targetWidth = newPlayAreaSize.Height *4/3; 
targetHeight = newPlayAreaSize.Height; 

double leftRightMargin = (newPlayAreaSize.Width - targetWidth) / 2; 
playArea.Margin = new Thickness(leftRightMargin, 0, leftRightMargin, 0) ; 
} else { 

targetHeight = newPlayAreaSize.Width * 3 / 4; 
targetWidth = newPlayAreaSize.Width; 

double topBottomMargin = (newPlayAreaSize.Height - targetHeight) / 2; 
playArea.Margin = new Thickness (0, topBottomMargin, 0, topBottomMargin); 


playArea.Width = targetWidth; 

playArea.Height = targetHeight; 

viewModel.PlayAreaSize = playArea.RenderSize; 


The UpdatcPIayAv-caSi^O method 
dakuhics ihe hew height a^d width, 

ihe Co^brols, av\d thch updates 
the l/icw/Wodds PlayAv-caSiz^ 
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Respond to swipe and keyboard input 

Your game will need to be able to respond to the user pressing keys and swiping a touchscreen to control the player ship. 
And since this is an MWM app, there’s an important separation of concerns. It’s the page’s job to keep track of the 
keypresses, swipes, and taps, and let the ViewModel know when they happen. It’s the ViewModel’s job to interpret them as 
game actions and call the appropriate methods on the Model. 


Keyboard event handlers arc added m code - behind 

Override the OnNavigatedTo () and OnNavigatedFrom () methods (like you did in Chapter 14) to add and remove 
event handlers for the Key Up and Key Down events, calling methods on the ViewModel to interpret the keystrokes. 


protected override void OnNavigatedTo(NavigationEventArgs e) { 
Window.Current.CoreWindow.KeyDown += KeyDownHandler; 

Window.Current.CoreWindow.KeyUp += KeyUpHandler; ^_ 

base.OnNavigatedTo(e); 

} 

protected override void OnNavigatedFrom(NavigationEventArgs e) { 

Window.Current.CoreWindow.KeyDown -= KeyDownHandler; 

Window.Current.CoreWindow.KeyUp KeyUpHandler; 
base.OnNavigatedFrom(e); 


l/Vi^dow.Cu\rV-c^i.Co\rclVi^dow ^ives 
you a io a Covcl^mdow 

objcdi ihai has events (oy basid U| 
behaviors like kcypv-csscs. This mdkes 
su\rc you\r keypresses art alv/dys 
handled by -the handld 


private void KeyDownHandler(object sender, KeyEventArgs e) { 

viewModel.KeyDown(e.VirtualKey); 

} 

private void KeyUpHandler(object sender, KeyEventArgs e) { 
viewModel.KeyUp(e.VirtualKey); 


Add page root event handlers for swipes and taps 

You’ll need to handle left and right swipes to move the player ship, and taps to fire. The event handlers 
were hooked up in the XAML on the previous page, so now you just need to add the event handlers. 


private void pageRoot_ManipulationDelta(object sender, ManipulationDeltaRoutedEventArgs e) { 

if (e.Delta.Translation.X < -1) 



viewModel.LeftGestureStarted(); 
else if (e.Delta.Translation.X > 1) 
viewModel.RightGestureStarted(); 


The /Wa^ipulatio^DcIta doi^s-ta^-tly -Piv-cs du\rmg a swipe 
as the usem’s moves, the c.DcltaT\ra^slatior> tells 

you hoy/ -Pa\r "the usev moved s'mdc the -Piv-'mj. 


private void pageRoot ManipulationCompleted(object sender, ManipulationCompletedRoutedEventArgs e) { 


viewModel.LeftGestureCompleted(); 
viewModel.RightGestureCompleted(); 


private void pageRoot_Tapped(object sender, 
viewModel.Tapped(); 


6 — The A1a^ifula*tio^Complc*tcd 
cvcrvt -rives 

TappedRoutedEventArgs e) { “SCV* s -f mJCV is The 

\/icv//V 1 odicl will Att\dt how 


-to deal wiiK -these events. 
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An Animatedlmage control displays the ships 

You can use the same Animatedlmage control that you used in Chapter 16 to display both 
the invader and player ships. The player ship only has a single, nonanimated image, so you 
can pass it an image list with one image (this gives you options to animate it later if you want). 



When the invader ships are hit, they should fade out rather than disappearing entirely. And 
anyone who’s played 80s arcade games knows that when the player ship is hit, it should 
flash for 2.5 seconds before the game resumes. So you’ll need to add these methods to the 
Animatedlmage control’s code-behind: 


public void 工 nvaderShot() { 

invaderShotStoryboard.Begin(); 

} 

public void StartFlashing() { 

flashStoryboard.Begin(); 

} 

public void StopFlashing() { 

flashStoryboard.Stop(); 


n 



And you’ll need to add the appropriate storyboards as well. The invaderShotStoryboard 
is a DoubleAnimation that fades the Opacity property from 1 to 0. f lashStoryboard 
is a key frame animation that toggles Visibility to make the control disappear and 
reappear. 


Add a control for the big stars 

The starry background has three types of stars: circles, rectangles, and big stars. 
The big stars are still pretty small — just 10 pixels by 10 pixels. So you’ll need to 
create a user control that has a Polygon. The stars can be different colors, so 
your control will need a public method to change the color of the Polygon: 

public void SetFill(SolidColorBrush solidColorBrush) { 
polygon.Fill = solidColorBrush; 



A static InvadersHelper class helps the ViewModel 

The ViewModel could use a helper class with factory methods for the invader, player ship, shot, and star controls. 
The StarControlFactory () method should pick a random number and return either a rectangle, ellipse, or 
big star. You can also add a private method to return a color at random (return Colors . LightBlue;) so 
StarControlFactory () can return different stars with different colors. 

You’ll also need a ScanLineFactory () method to create the simulated scan lines. Each scan line is a rectangle 
with Fill set to new SolidColorBrush (Colors . White) ， Height set to 2, and Opacity set to 丄 


All of the factory methods should take a double scale parameter, which we’ll talk about with the ViewModel. 

















Use the Settings charm to open an About pop up 

In Chapter 15 you learned how to add a callback for the About command in the Settings 
charm. Your job is to figure out how to add a Popup control to your page. Here’s the code- 
behind to hook it up to the Settings charm — it’s also got the event handler for the game’s 
Start button that you’ll need to add: 




public InvadersPage() { 

this. 工 nitializeComponent(); 


SettingsPane.GetForCurrentView().CommandsRequested 

+= 工 nvadersPage—CommandsRequested; 

} _ 

void InvadersPage 一 CommandsRequested (SettingsPane sender, 

SettingsPaneCommandsRequestedEventArgs args) 

{ 

UICommandlnvokedHandler invokedHandler = 


new UICommandlnvokedHandler(AboutlnvokedHandler); 
SettingsCommand aboutCommand = new SettingsCommand( 

’ 'About，'，"About Invaders’’ ， invokedHandler); 
args.Request.ApplicationCommands.Add(aboutCommand); 

} 

private void AboutlnvokedHandler (IUICommand command) { 
viewModel.Paused = true; 


Head Fipst 


aboutPopup • 工 sOpen = true; 

} 

private void ClosePopup (object sender, RoutedEventArgs e) 
aboutPopup • 工 sOpen = false; 
viewModel.Paused = false; 

} 

private void StartButtonClick (object sender, RoutedEventArgs e) 
aboutPopup • 工 sOpen = false; 
viewModel.StartGame(); 


Head First C# presents, 

invaders 

L.arn to build tliis app! 

Lear'ng is fun, and it's 
easier than you think. Learn 
no re here ： 


-the pop up that wc 
t^n\t up y/i-th—you use 3 
StddkRa^cl o\r 6fr\d "to put 
v/hatevcv- dohtirols you y/a^i 
msidc of it The avrov/ dose 


Here’s a XAML code snippet to get you started: 

<Popup x : Name="aboutPopup M Grid.RowSpan="2" 

VerticalAlignment="Stretch" HorizontalAlignment= M Right" 
Width= M 4 00" 工 sOpen= n False n > 


butto 的 is hooked up "to the 
ClosePopup cvch-t ha^dleir. 


<StackPanel Background= n Blue" VerticalAlignment= M Stretch" 

HorizontalAlignment= M Stretch" Width= M 360" Margin= M 20"> 


One more thing: it will look nicer if the pop up transitions smoothly out when it’s opened. See if you can figure out 
how to use the Transitions collection in the Properties window to add an EntranceThemeTransition. 


Transitions (Collection) 


■ 













Puild the ViewModel 


The ViewModel has two classes in it. Invaders ViewModel is the main ViewModel object, and 
BooleanVisibilityConverter is the same as the one you used in Chapter 16 — you can use it to 
bind the “Game Over” and “Paused” TextBlock controls’ Visible properties to the Game Over and 
Paused properties on the ViewModel. So the rest of this lab is all about building out the ViewModel. 



Here’s the top of the Invaders ViewModel class, to get you started: 

using View; 
using Model; 

using System.ComponentModel; 
using System.Collections.ObjectModel; 
using System.Collections.Specialized; 
using Windows.Foundation; 

using DispatcherTimer = Windows•UI.Xaml.DispatcherTimer; 
using FrameworkElement = Windows.UI.Xaml.FrameworkElement; 


This is -the same you used m 

l^> -to mdirtdje -the spv-i-tes -Pov- -the 
u Bccs or> a sta\rvy NijhF pvojcdi ： dvcatmj 
d \rc3ci—or>ly 0bscv"V3blcCollcd*tioh 

-field o-f 6o>vbro|s, artd only 3r\ 

I hi oii-f yCol Icd-tio^Cha^ jed pvopev-ty -feo 

C^apsula-tc i"t *Pv*onr» -the \/icv/. 


class InvadersViewModel : 工 NotifyPropertyChanged { 

private readonly ObservableCollection<FrameworkElement> 

_sprites = new ObservableCollection<FrameworkElement>(); 
public 工 NotifyCollectionChanged Sprites { get { return sprites; } } 


public bool GameOver { get 



return model.GameOver; 


private readonly ObservableCollection<obj ect> 一 lives = 

new ObservableCollection<object>() 
public INotifyCollectionChanged Lives { get { return lives; } } 



private 

private 

private 

private 

private 


new InvadersModel(); 

=new DispatcherTimer(); 



readonly InvadersModel 一 model 
readonly DispatcherTimer 一 timer = 

FrameworkElement _j)layerControl = null; 
bool 一 playerFlashing = false; 

readonly DictionaryCInvader, FrameworkElement 〉 一 invaders = 

new Dictionary<Invader A FrameworkElement 〉（）； 
readonly Dictionary<FrameworkElement, DateTime> 一 shotlnvaders = 

new Dictionary<FrameworkElement, DateTime>(); 
readonly Dictionary<Shot, FrameworkElement 〉 一 shots = 

new Dictionary<Shot, FrameworkElement>(); 
readonly Dictionary<Point, FrameworkElement 〉 一 stars = 

new Dictionary<Point, FrameworkElement 〉（）； 

readonly List<FrameworkElement> 一 scanLines = 

new List<FrameworkElement>(); 
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Handling user input 


You already saw how the main page in the View calls methods 
in the ViewModel to handle keypresses, swipes, and taps. Here 
are the methods that it calls. The user needs to be able to use 
the keyboard or touch screen interchangeably. To accomplish 
this, both the tap and spacebar cause the ViewModel to call the 
Model’s FireShot () method. Moving the player’s ship left and 
right is a little more complex: both keypresses and swipes update 
DateTime? fields that contain the date of the most recent keypress 
or swipe, or are null if there is no current keypress or swipe. 


Did you notice how all of the methods on this 
page have the internal access modifier? 
Thafs because we added these methods 
by first adding the code from a few pages 
earlier, and then using the Generate Method 
Stub feature of the IDE to create the method 
declarations. The internal modifier means 
the method is publicly accessible from inside 
this assembly, but appears as private to 
other assemblies. You can learn more about 
assemblies in leftover #3 in the appendix. 


private DateTime? 
private DateTime? 


leftAction = null; 
rightAction = null 



The \/icy/Modcl uses Nullablc<Pa*tcTimc> fields 
•to keef bracV *bKc most rtCtyii \t(i ov /十七 

by a keyless ov a ysUrt. 


internal void KeyDown (Windows.System.VirtualKey virtualKey) 
if (virtualKey == Windows.System.VirtualKey.Space) 
model.FireShot(); 


if (virtualKey 

_leftAction : 

if (virtualKey 

rightAction 


Windows.System.VirtualKey.Left) 
DateTime.Now; 

Windows.System.VirtualKey.Right) 
: DateTime.Now; 


"The l/icw da I Is "the method -fv*orw 

the page s key cvch-t ha^dlcv-, pass— it m 
七 he key that was pv-csscd. I-P the usev hit 
the spadcba\r the l/icw/Wodd tells the Model 
"to -f ire s shot. |-P -the pldyev pvessed the 
o\r \righ-t a\r\ro 劝 "the ov 

-field jets upated. 


internal void KeyUp (Windows.System.VirtualKey virtualKey) 
if (virtualKey == Windows.System.VirtualKey.Left) 

_leftAction = null; 

if (virtualKey == Windows.System.VirtualKey.Right) 
rightAction = null; 


l-f i\\t player *tKc Ic-ft ov 

f/i 七 sets i\\t appropriate 
•fco m\\- 


vi^vt key, 
-f ield bo y\ 


internal void LeftGestureStarted() { 

leftAction = DateTime.Now; 


internal void LeftGestureCompleted() { 

leftAction = null; 


internal void RightGestureStarted() { 

rightAction = DateTime.Now; 


internal void RightGestureCompleted() 

rightAction = null; 


internal void Tapped() 
model.FireShot(); 


Tins lc*ts tiw'CV - 

iiar^dlcv ou*t if ’i 七 

should move tKc playev ship by 

一 -fields- 



The dal Is -these 

rwC-thods \y\ rts 
har>dlcvs (ov "the usev sy/ipc 
tap jes-tuves. W\\tv\ 七 he 
usev- sy/ipcs Ic-Pi o\r v-i^lvt ii 
updates -the oy\ o\r 
-field, ar\d i-P 

七 he usev taps i-t -Piv-cs a shot 


The pay’s Tapped v/ill -five 
y/hen -the playev- c\\tks -the 
stavt button, so -the 
v/ill s-ta\rt with 七 he player 
-Piv'mj a shot Cby\ you 
-fijuve out hoy/ -to n\od\(y 
TappcdO {jo avoid -this? 
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Puild the InvadersViewModel methods 

We’ll get you started with a constructor and two useful methods. 

THB lNVAt>eesVie^Maoeu COUSl^UCTO^ WOOKS UP TUB 
lNVAt>eissMai>eu BVBMT HANDUBRS AMD BMDS THB 



public 工 nvadersViewModel() 
Scale = 1; 




_model.ShipChanged += ModelShipChangedEventHandler; 
—model•ShotMoved += ModelShotMovedEventHandler; 


model.StarChanged += ModelStarChangedEventHandler; 


timer • 工 nterval = TimeSpan.FromMilliseconds(100); 
timer.Tick += TimerTickEventHandler; 


EndGame() 

} r 

-the jarwc so i-t loads 
wrth 七 he 6fBn\C Ovcv S^VCC^- 


Tidih 9 ， loo ^illiscdohds updates i\u 
\/i 〜 10 times a sedohd. That S ^oi the 
sarnC 仏％ as a vaic, wcVc 

usm 9 ahimatiohs -to move spv-ites 扣 ouhd. 


I/Vhch the Sdalc pv-opev-ty 
is seiio I, ihe l/icw/Wodd 
will update the l/icw with 
a /-to-l scale ^OOySOO 


ba 七七 I^Pidd - bu 七七 he \/icvv 
will <\uiddy updalc -the 

l/icw^Iodds PlayAv-coiSi z^, 

which updates -the S^le 
p\ropc\rty. 


THB Sta^ambO METHOD CUBANS THB INVADERS AMD 
SHOTS PROM THB SPRITES COUUBCTI^N, TBUUS THB 
M^DBU TO START THB ^AMB, AMD STARTS THB TIMER. 


public void StartGame(){ 

Paused = false; 

foreach (var invader in —invaders•Values) —sprites•Remove(invader); 
foreach (var shot in _shots.Values) _sprites.Remove(shot); 

OnPropertyChanged ( "GameOver"); < ： —— i\\t !^\oAt\ sta\rts the it ^datti 

timer Start () ; i*b f\rofC\rty, so the \/icwModd I ires 

} ~~ a Pv-ofcv-tyCha^jcd ev ⑶七 *to update the \/icv/- 

THB ISeciseAreScANUlNesO METHOD ADDS SIMULATED SCAM UMBS. 


: s 


private void RecreateScanLines() { 

foreach (FrameworkElement scanLine in 
if (—sprites•Contains(scanLine)) 
_sprites.Remove(scanLine); 
scanLines.Clear(); 


scanLines) 

You’ll i\tt& bo build 
-tKis -fat-tovy 


for (int y = 0; y < 300; y += 2) { ^ 

FrameworkElement scanLine = InvadersHelper•ScanLineFactory(y. 


400, 


Scale); 


scanLines.Add(scanLine); 

sprites .Add (scanLine) ; The -PadWy method uses this 

av^ur^rrt "to scale -the ve 乙 tarries 

up bo the piropcv s'i^jC ar>d loda*tior>. 
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The View's updated whew the timer ticks 

When the InvadersModel fires a ShipChanged event, the ViewModel 
needs to figure out what kind of ship changed, and update its collections 
appropriately so that the View accurately reflects the current state of the Model. 

Here’s how the ShipChanged event handler works: 

void TimerTickEventHandler(object sender, object e) { 
if (—lastPaused != Paused) 

Use the —lastPausedfield to fire a Property Changed event any time 
the Paused property changes. 

if ( !Paused) 

If both the —leftAction and —rightAction fields have a value，that means 
there are either two keys being mashed or a key and a szvipe at the same 
time 一 use the one zvith the later time to choose a direction to move the player. 

If not，choose the one with a value and use that to pass to jrnodeLMovePlayerQ. 

} 

Tell the InvadersModel to update itself. Then check the Score property. If it 
doesn’t match —model. Score，update it andfire a Property Changed event. 

Update the Lives so that it matches —model.Lives by either removing an 
object or adding a new object (). 

foreach (FrameworkElement control in —shotlnvaders•Keys•ToList()) 

{ 一 

Each key in the _shotInvaders Dictionary is an Animatedlmage control ， 
and its value is the time that it died. It takes half a second for the invader 
fade-out animation to complete，so any invader who died more than 
half a second ago should be removed from both —sprites and —shotlnvaders• 

} 

If the game is over，fire a Property Changed event and stop the timer. 
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The player's ship caw move and die 

When the InvadersModel fires a ShipChanged event, the ViewModel 
needs to figure out what kind of ship changed, and update its collections 
appropriately so that the View accurately reflects the current state of the 
Model. Here’s how the ShipChanged event handler works: 

void ModelShipChangedEventHandler (object sender, ShipChangedEventArgs e) { 

if (!e.Killed) { X do^uasi c-ShipUpd^cd io iht 

if (e. ShipUpdated is Invader) { ^ appropriate dlass, cithcv- (hvadev- o\r PlaycvShip. 

Invader invader = e.ShipUpdated as Invader; 

If the —invaders collection doesn’t contain this invader, use the 
Invaders ControlFactory Q method to create a neiv control and add it to the 
collection，and to the sprites. Otherwise，move the invader control to its 
correct location and resize it — and don f tforget to pass in the Scale value! 
Here’s a helpful method that you might want to add to InvadersHelper: 

InvadersHelper.ResizeElement(invaderControl, invader.Size.Width * Scale, 

invader.Size.Height * Scale); 

} else if (e.ShipUpdated is Player) { 

If the _playerFlashing field is true，then the player ship is currently flashing 
because it previously died; stop it from flashing. Then check if _player Control 
is null. If it is，use PlayerControlFactoryQ to create a player and add it to the 
sprites; otherwise, move and resize the player ship. 

} else { 

if (e.ShipUpdated is Invader) { 

If the invader isn’t null，call its InvaderShotQ method (you 7 / need to look up 
its control in the —invaders dictionary, then cast it to an Animatedlmage). 
Then add the invader to the —shotlnvaders dictionary and remove it from 
jinvaders. The —shotlnvaders dictionary contains the time that each invader 
was shot. The ViewModel doesn’t remove the invader f s Animatedlmage 
controlfrom the sprites until it,sfinishedfading out. 

} else if (e.ShipUpdated is Player) { 

Cast _playerControl to the Animatedlmage, start it flashing, and set the 
_playerFlashing field to true. The flashing animation can keep going until 
the ViewModel gets another Ship Changed event from the Model，because 
that means gameplay has resumed. 





"Shots fired! 


jj 


The InvadersViewModel's event handlers for the ShotMoved 
and StarChanged events are pretty similar. 



void ModelShotMovedEventHandler(object sender, ShotMovedEventArgs e) { 
if ( !e.Disappeared) 

{ 

If the shot is not a key in the _shots Dictionary, use its factory method to 
create a new shot control，then add it to _shots and _sprites. If it is in the 
—shots Dictionary, then it’s already on screen，so look up its control and 
use the helper method to move it using its Location property. 

} else { 

The shot disappeared，so check _shots to see if it’s there. If it is，remove its 
controlfrom —sprites，and remove the Shot objectfrom _shots. 



void ModelStarChangedEventHandler(object sender A StarChangedEventArgs e) { 
if (e.Disappeared && _stars.ContainsKey(e.Point)) 

Look up the control in _stars and remove it from _sprites. 

} else { 

if ( 丨 —stars.ContainsKey(e.Point)) 

Use the factory method to create a new control, add it to _stars (using 
the Point from the EventArgs as the key)，and add it to the sprites. 

} else { 

Stars typically won’t change locations，so this else clause probably ivon f t 
get hit — but you can use it to add shooting stars if you 
want. Look up the star’s control in _stars and use a 
helper method to move it to the new location. 
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And yet there's more to do 


Think the game’s looking pretty good? You can take it to the next level with a few more additions: 

Add sounds 

The MediaElement XAML tag lets you add sounds to your apps. Gan you figure out how 
to use it to add sounds when the invaders march, the player fires shots, and ships are 
destroyed? This page will help: 

http://msdn.niicrosQft.CQiii/en-us/librar,y/windows/apps/xanil/hh465160.aspx 


Add a mothership 

Once in a while, a mothership worth 250 points can travel across the top of the battlefield. 

If the player hits it, ho gets a boms. ^ shidd ^ ^ ^ lots ^ little bl f ks ^ aisa PP ea, 

Add Shields j us 七 •… vadevs y/h ⑶ -thcyVc hit but dor / 七 add "to the sdov-c- 


Add floating shields the player can hide 



You can add simple shields that the enemies 


and player can’t shoot through. Then, if you really want your game to shine, add breakable 
shields that the player and invaders can blast holes through after a certain number of hits. 


Add divebombers 

Create a special type of enemy that divebombs the player. A divebombing enemy should 
break formation, take off toward the player, fly down around the bottom of the screen, and 
then resume its position. 


Add more weapons 

Start an arms race! Smart bombs, lasers, guided missiles...there are all sorts of weapons 
that both the player and the invaders can use to attack each other. See if you can add throe 
new weapons to the game. 

Add a Preferences command to the Settings charm 

You can add a Preferences command to the Settings charm just like you did with the About 
command to open a second pop up that lets you turn scan lines on and off, change the 
number of lives, mute sounds, etc. 


Tkis is your ckance to skow oif! Diet you come up witk a cool new 
version oi tke game? Putlisk your Invacters code on CoctePlex or 
anotlver project kostingf website，tken claim your dragging rigkts on 
tke Heact First C# lorum ： www.keactiirstlats.com/tooks/Wcsliarp/ 
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17 bonus project! 




Build a Windows Phone app 







You’re already able to write Windows Phone apps. 


Classes, objects, XAML, encapsulation, inheritance, polymorphism, LINQ, MVVM... 
you’ve got all of the tools you need to build great Windows Store apps and desktop 
apps. But did you know that you can use these same tools to build apps for 
Windows Phone? It’s true! In this bonus project, we’ll walk you through creating a 
game for Windows Phone. And if you don’t have a Windows Phone, don’t worry — you’ll 
still be able to use the Windows Phone emulator to play it. Let’s get started! 


this is a new chapter 
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bonus project 


fee Attack! 

You’ll be building a Windows Phone 8 game called Bee Attack. There’s a hive 
of seriously ticked-off bees, and the only way you’ll pacify them is with a tasty, 
tasty flower. The more bees you catch with the flower, the higher your score. 



Catch the bees as they fly down the screen. 

The hive moves back and forth across the top of the screen, 
launching bees down at your flower. As you catch more 
and more bees, the hive shoots them out more frequently 
and moves farther to the left or right between bees. 


Control the flower with touch gestures. 

You control the flower by dragging left and right 
across the screen. It will follow your finger as you drag, 
letting you catch the bees as they fly down toward the 
bottom. You’ve only got five misses before the game 
ends, and it gets harder as the game goes on. 
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build a windows phone game 


Pefore you begin... 


To build this project, you need to install Visual Studio 2012 for Windows Phone. You can 

download the free Express edition here: 

http:/ / www.microsoft.com/ visualstudio/ eng/products/visual-studio-express-for-windows-phone 

You have two options for actually running the game. The easiest way to do it is to use the Windows 
Phone Emulator that ships as part of Visual Studio. 


Run the game in the emulator. 


By default, Visual Studio for Windows Phone runs its apps in 
the emulator, which emulates a complete Windows Phone 8 
(including Internet connection, a fake GSM network, and more). 



> EmulatorWVGASIZMB 


Ruk\ biA*t*bor\ *m 

i\)t IPS- la^^cs 

七 he cmula-tov-* 


The Windows Phone Emulator requires Hyper-V 

Hyper-V is the virtualization technology for Windows 8, but 
not every CPU or edition of Windows 8 can run Hyper-V. 
Microsoft has this guide to help you get it up and running: 


httD ： //msdn.microsoftcom/en-us/Hbrarv/windowsDhone/develoD/ii863509.asDx 


Hyper-V will run on a virtual machine hosted inside VMWare, VirtualBox, 
Parallels, or another virtualization product if your processor supports 
it You’ll need to consult your VM software documentation or support 
website for details (you may need to enable an option like “nested virtual 
machines” or “virtualize VT-x or AMD-V^ to make it work). 


The cmula-fcov lets you 
you\r l/Vir>dov/s Pho^c apps ov\ 
youv* dorif»pu"tc\r. I 



Run the game on your Windows Phone. 

If you connect a Windows Phone 8 to your computer via 
a USB cable, then you can debug your app on the device. 


► Device ▼ 

For this to work, your phone must be registered with an 
active Windows Phone Dev Center account (which might 
cost money): https:/ / dev.windowsphone.com/ . 

Once you have this account set up, you can register your 
phone for development. This page will show you how: 






Windows Phone Developer Registration 


Developer Phone Registration 


■8 Windows Phone 


This tool unlocks your phone for debugging and testing Windows phone apps. To usr^J 
must have the following: 

• A current developer account. 

• The Microsoft ID and password associated with your developer account available. 

• A Windows Phone that is connected to your computer, powered on, and screen ur 
For more information about registering as a developer, see Registration Info. 

Status: Identified Windows Phone 8 device. Click the Register button to unlock the phe 


Sign In 


Sign in 


a 


Microsoft account Wi'st's this? 




Don't have a Microsoft account? Sign up now 



Privacy & Cookies | Terms 
©2013 Microsoft 


http:/ / msdn.microsoft.com/en-us/librarv/windowsphone / develop/ fF7 69508.aspx 


you are here ► 
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bonus project 

o 6125AT5 A N5W \AJINt>^>WIS PH^NB APP. 

Open Visual Studio 2012 for Windows Phone and create a new Windows 
Phone App project called Bee Attack. (If you choose a different name, that’s 
OK — but the namespaces in our screenshots will be a little different from yours.) 


New Project 


Recent 

A Installed 

^ Templates 
J Visual C# 

Windows Phone 
XNA Game Studio 4.0 
Visual Basic 
0 Visual C++ 

Samples 

I> Online 


Sort by: 

Default ▼ \\~ ：n 


Search Installed Templates (Ctrl+E) fi 

u 

Windows Phone App 

▲ 

Visual C// 

Type: Visual C// 

A project for creating a Windows Phone 
application 

D # 

Windows Phone Databound App 

Visual C# 


Windows Phone Class Library 

Visual C# 


MY APPLICATION 


Windows Phone Panorama App 

Visual C# 


page name 

u 

Windows Phone Pivot App 

Visual C# 



u 

Windows Phone XAML and Direct3D App 

Visual C# 




Windows Phone XAML and XNA App 
n Windows Phone Unit Test App 
[~ ] Windows Phone HTML5 App 
g Windows Phone Audio Playback Agent 
__ Windows Phone Audio Streaming Agent 


□ 

Name: | BeeAttack_ _ 

Location: C:\Users\Public\Documents\Visual Studio 2012\Projects 

Solution name: BeeAttack 


New Windows Phone Application 


D 


Select the Windows Phone Platform you want to target for this application. 

Target Windows Phone OS Version: 

Windows Phone OS 8.0 ^1 


OK 


Cancel 



LOOK THE^U^H TH5 FILES THAT TH5 6E5AT6D. 

The Visual Studio for Windows Phone IDE should be very familiar, because 
it’s almost identical to the IDE for the Windows 8 and Desktop editions. When 
you create the new project, the IDE 
automatically adds files that include: 


BeeAttack - Microsoft Visual Studio Express 2012 for Windows Phone 
RLE EDIT VIEW PROJECT BUILD DEBUG TEAM DESIGN FORMAT TOOLS TEST WINDOW 
O - © ► Emulator WVGA 512MB ， Debug ， Any CPU - 3 ^8 K _ 


HELP 

:la 


The XAML and G# files for 
the main page (MainPage. xaml 
and MainPage. xaml.cs) 

The main app file (App. xaml 
and App.xaml.cs) 

An Assets folder 

AC# source file to hold static 
resources for localized strings 
(LocalizedStrings.es) 

An app manifest, resources, 
and a few more files and 
folders (but nothing else 
you’ll need for this project) 


g Device 

° Orientation 
o 

I Display 

% 

^ Theme 
5 Accent 

Show chrome 
Clip to display 


▼ ? X 


國 囿 


E 3 


480 x 800 
WVGA@ 100%scaU 


kMY APPLICATION- 


□ 


page name 


69.38% ▼ K: B: [^] P 
Error List 

T ， 

Description 


Error List Output 




10 localize tne displayea strings co ^ 

keys in the app's neutral language r ▲ 
replace the hard-coded text value be 
with the binding clause whose path p- 

For example: 

Text="{Binding Path=LocalizedRes. 

This binding points to the template' 

Adding supported languages in the Pr- ■ 
new resx file per language that can 
UI strings. The binding in these exai 
attributes to be drawn from the • res I 
CurrentUICuiture of the app at run t j 


<! -- TitlePanel contains the name of the 
<StackPanel x : Name="T itlePanel" Grid . Row 
<TextBlock Text="MY APPLICATION" Sty 
<TextBlock Text="page name" Margin:" 
</SLoi.kPdiiel> 

<! -- ContentPanel - place additional cont 
<Grid x : Name="ContentPanel" Grid.Row="l" 


<!--Uncoaaient to see an alignment grid t， 
aligned on conmon boundaries. The ii 
account for the Systen Tray. Set thi 
if the Systen Tray is hidden. 

Before shipping remove this XAML and 
<!--《Image Source="/Assets/Align»entGrid 
</Grid> 


Quick Launch (Ctri+Q) 


Solution Explorer 

fit Q & : § 



</phone:PhoneApplicationPage > 


Search Solution Explorer (Ctri+;) 

Solution 'BeeAttack' (1 project) 
J 回 BeeAttack 

> f* Properties 

> _ References 

> 篇 Assets 

> 0 Resources 

> D Appjtaml 

> c» LocalizedStrings.es 

> MainPage.xaml 


m 


▼ 平 X 

Search Error List fi * 

Colu... ▲ Project ▲ 


Solution Explorer Class View 
Properties 

Name <No Name> 
Type TextBlock 

S*»afrh Pmppitips 

Arrange by. Category ▼ 

> Brush 

^ Appearance 
^ Common 
CacheMode 

Text page name 

DataContext 

V 

> Layout 

> Text 

> Transform 

> Miscellaneous 




n x 


-? x 

<> >[p] 

P ， 


-? x 

P 


I New 1 □ 


I New |o 
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O WIDE TH5 TITLE PAN5L ON TH5 MAIN PA^B. 

The main page, MainPage.xaml, should already be open in the IDE (if it’s not, 
open it). This is the main page displayed on your app. Look through the XAML 
code for it and find the StackPanel called TitlePanel. 


<!--TitlePanel contains the name of the application and page title--> 

<StackPanel x : Name= M TitlePanel" Grid.Row= M 0 M Margin= n 12,17,0,28 n > 

<TextBlock Text= M MY APPLICATION” Style= M {StaticResource PhoneTextNormalStyle} M Margin= n 12,0 n /> 

<TextBlock Text= M page name" Margin= n 9,-7,0,0 n Style= M {StaticResource PhoneTextTitlelStyle}"/> 

</StackPanel> 

The IVB ^vesied Ma'mPajc- 
y/i-th a StadkPa^cl 

Edit the XAML and add Visibility="Collapsed" to the StackPanel harmed Ti-tlcPa^cl that 

so the title TextBlocks disappear. This will make your app appear to be full screen. 七 7c^*tBlodks 

广 Add ihis \/isibilrty p\ropcv-ty 

<! --TitlePanel contains the name of the application and page title --〉 \I *to mdke i"t dis3ppc3V". 

〈StackPanel x : Name= M TitlePanel M Grid.Row= M 0 M Margin= n 12,17,0,28 n Visibility= n Collapsed M > 

<TextBlock Text= M MY APPLICATION” Style= M {StaticResource PhoneTextNormalStyle} M Margin= n 12,0 n /> 
<TextBlock Text= M page name" Margin= n 9,-7,0,0 n Style= M {StaticResource PhoneTextTitlelStyle} M /> 

</StackPanel> 


r 


...» … i23 a", 


MY APPLICATION 


page name 


e) 


__ 


L 


J 









you are here ► 
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6125AT5 TH5 MOD5L POLD512 AND ADD TH5 BeeATTACKM^eu CLASS- 

BeeAttack is an MWM app, so it needs its Model, View, and ViewModel layers. We’ll start by creating 
the Model layer. In this case, the Model is a single class called BeeAttackModel, which lives in the 
Model folder and namespace. Create the Model folder and add the BeeAttackModel class to it: 



Search Solution Explorer (Ctrl+;) fi 


Solution 'BeeAttack' (1 project) 
a 回 BeeAttack 

> A Properties 

> References 

> 篇 Assets 
麵 Model I 

> m Resources 

> D App.xaml 

> c 轉 LocalizedStrings.es 

> MainPage.xaml 

Solution Explorer Class View 



Cv*ca*tc the Alodcl -Poldcv- 
"the Solutioh Explovcv-, 
仏⑶ oh i-t 

ddd 3 C3\\t& 



Search Solution Explorer (Ctrl+;) fi 

Solution 'BeeAttack' (1 project) 

a 回 BeeAttack 

> A Properties 



▼ 


Here's the code for the BeeAttackModel class. It has properties to get the number of misses left, the 
score, and the time between launching bees, and it has a method to start the game. It also has methods to 
tell it the player moved the flower, tell it a bee landed, and get the hive location for the next bee launch. 


using Windows.Foundation; 

class BeeAttackModel { 

public int MissesLeft { get; private set; 
public int Score { get; private set; } 
public TimeSpan TimeBetweenBees { 

get { 

double milliseconds = 500; 


]The 1 /icwModcl will use these 

r prop 饮 ties "to update -the stoYt 

hurwbev- o-p misses Ic-f-t ， 


milliseconds = Math.Max(milliseconds - Score * 2.5, 100); 
return TimeSpan.FromMilliseconds(milliseconds); 


private double flowerWidth; 
private double beeWidth; 
private double flowerLeft; 
private double playAreaWidth; 
private double hiveWidth; 
private double —lastHiveLocation; 
private bool _gameOver; 

private readonly Random random = new Random(); 


TV^c speeds uf as 
playcv 3>r\d move 

bees. TWis pv-opev-ty takula-tcs 
time between bees based 
ov\ stov-c. 


public void StartGame (double flowerWidth, double beeWidth, double playAreaWidth, double 


flowerWidth = flowerWidth; 
beeWidth = beeWidth; 
playAreaWidth = playAreaWidth; 
hiveWidth = hiveWidth; 
_lastHiveLocation = playAreaWidth / 2; 
MissesLeft = 5; 

Score = 0; 

_gameOver = false; 

OnPlayerScored(); 


V 1 / 

丁 he method v-cscts the 

ga^c. The 1 /icwModcl will pass it the 
widths -flower bcc, play area, av\d 
hi% v/hidh i-t uses ih i-b mc-thods. 


hiveWidth) 
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public void MoveFlower (double flowerLeft) 
flowerLeft = flowerLeft; 


This method is ddlled dr>y 

七 ‘e 七 he player moves -the 
-flowcv-. H jus 七 updates 七 he 
•flowers position. 



public void BeeLanded (double beeLeft) { 

if ( (beeLeft < flowerLeft) 丨丨 (beeLeft > _flowerLeft + flowerWidth)) { 
if (MissesLeft > 0) { 

MissesLeft--; 


OnMissed(); 

} else { 

一 gameOver = true; 
OnGameOver(); 

} 

} 

else if (!_gameOver) { 

Score++; 


^licvcvcv- a bcc la^ds, Model tiicdks 
-tKc bcc s Ic-ft tov-hcv is msidc *bKc 
bou^dav"ics <Jc -flov/cv". |-f i*ts r\o*t> 
playcv missed ； flayer sdoved- 


OnPlayerScored(); 


public double NextHiveLocation() { 

double delta = 10 + Math.Max(1, Score * .5); 

if (_lastHiveLocation <= hiveWidth * 2) 
_lastHiveLocation += delta; 
else if (_lastHiveLocation >= _playAreaWidth 
_lastHiveLocation -= delta; 

else 


£ve\ry -time a bcc is bushed, 
the \/icwModd uses this 
rwethod -fco -Pihd the hext 
^ ^ lioviz^h'tcll lo^atioh -fo\r -the 

hive "to -the bee. The 

mdkes su\rc "the 111vc 
doesh t move "too -Pav-—as -the 

hiveWidth * 2) , /, .. 

playe\r sdo\rcs mo\rc, the hive 

moves -Pu\rthc\r between bees. 


lastHiveLocation += delta * ( random.Next(2) == 0 ? 1 : -1); 


return 一 lastHiveLocation; 

} 一 

public EventHandler Missed; 
private void OnMissed() { 

EventHandler missed = Missed; 
if (missed != null) 

missed(this, new EventArgs()); 

} 

public EventHandler GameOver; 
private void OnGameOver() { 

EventHandler gameOver = GameOver; 
if (gameOver != null) 

gameOver(this, new EventArgs()); 

} 

public EventHandler PlayerScored; 
private void OnPlayerScored() { 

EventHandler playerScored = PlayerScored; 
if (playerScored != null) 

playerScored(this, new EventArgs()); 



The ViowModcl lis*bcr»s *to *bV>csc 
-tiivcc events so i*t c ^ y \ update 
i\^t V\t>N v/^c^cvcv i\\t playcv- 
misses, stoves, ov loses 



you are here ► 
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6125AT5 TH5 VIEW F^UDBE AND BUIUD THE BeeCoNT^o^ 

The View consists of two Windows Phone user controls. The first one is called 


BeeControl, an animated bee picture that moves down the play area. Start by 
creating the View folder. Right-click on it in the Solution Explorer and add a new item, 


then add a new 



Windows Phone User Control called BeeControl.xaml to the folder: 


』 Installed 

A Visual C# 

Code 

General 

Windows Phone 
XNA Game Studio 4.0 

Online 


Add New Item - BeeAttack 


Sort by: Default 


Windows Phone Portrait Page Visual C# 
圍 Windows Phone Landscape Page Visual C# 
Windows Phone User Control Visual C# 


□ 


Windows Phone Panorama Page Visual C# 


_ Windows Phone Pivot Page 




kC 林 


SRGS Grammar 

Voice Command Definition 

Class 


Visual C# 

Visual C# 

Visual C# 

Visual C# 


Name: 


BeeControl.xaml 


Search Installed Templates (Ctrl+E) 


Type: Visual C# 

Add a new Windows Phone User Control 


Type words to 


Add 


Solution Explorer 


企 T © ▼ 泛葫 _ <> A P 


Search Solution Explorer (Ctrl+;) 

EJ] Solution 'BeeAttack' (1 project) 
a [c§ BeeAttack 

> A Properties 

> References 

> ^ Assets 

Model 

> m Resources 
』雄 View 

> ti BeeControl.xaml.es 

> ADD.xaml 

Solution Explorer Class View 


p 


▼ 


Edit the XAML code in BeeControl.xaml. Find the Grid named LayoutRoot, give 
it a transparent background, and add an Image control to it named image. Here’s 
what the XAML should look like: 

<Grid x ： Name= n LayoutRoot" Background:’▼ Transparent n > 

<Image x : Name= " image" Stretch: n Fill’▼/> 

</Grid> 


You’ll need the animated flapping bee 
graphics, as well as the flower and hive 
graphics. Download the graphics files 
from the Head First Labs website: 

http:/ / www.headfirstlabs.com/hfcsharp 

Then right-click on the Assets folder and add 

the files as existing items. Once you’ve 
added the files, your Assets folder should look 
like this: - 


Solution Explorer 


企 I T o ，々园圖 

Search Solution Explorer (Ctrl+;) 

> 0 Tiles 

0 AlignmentGrid.png 
0 Applicationlcon.png 
0 Bee animation l.png 
0 Bee animation 2.png 
0 Bee animation 3.png 
0 Bee animation 4.png 
> 0 Flower.png 

0 Hive (outside).png 
Model 


Solution Explorer Class View 


P 


p 


▲ 


▼ 
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Now you’re ready to add the C# code-behind for BeeControl. Here’s the code for it, 
which should be added to BeeControl.xaml.es.. 

using Microsoft.Phone.Media; 
using System.Windows.Media.Animation; 
using System.Windows.Media.Imaging; 



public sealed partial class BeeControl : UserControl 
public readonly Storyboard Fallingstoryboard; 

public BeeControl() { 

this. 工 nitializeComponent(); 

St art Flapping (TimeSpan . FromMi Hi seconds (30 ))； 


public BeeControl (double X, double fromY, double toY, EventHandler completed) : this () { 


After a storyboard completes its 
animation, it fires its Completed event. 
This overloaded BeeControl constructor 
takes an EventHandler delegate as a 
parameter, which the ViewModel uses to 
_figure out when the bee lands. 



FallingStoryboard = new Storyboard(); 

DoubleAnimation animation = new DoubleAnimation(); 

Storyboard.SetTarget(animation, this); 

Canvas.SetLeft(this, X); 

Storyboard.SetTargetProperty(animation, new PropertyPath( M (Canvas.Top) 
animation.From = fromY; 
animation.To = toY; 

animation.Duration = TimeSpan.FromSeconds(1); 


This dnimd 七 ion 
moves ihc bcc doym 
七 he Canvas play 
s-tav-tmg a-t 
"the hive and ⑶ dmg 
七 he -Plov/cv-. 


if (completed != null) FallingStoryboard.Completed += completed; 


FallingStoryboard.Children.Add(animation); 
FallingStoryboard.Begin(); 


public void StartFlapping (TimeSpan interval) { 

List<string> imageNames = new List<string>() { 

"Bee animation 1.png ", "Bee animation 2.png M , 


l The delegate passed m as by \ 

\ is hooked up *to S-tov-yboav-d^s 

"Bee animation 3.png M , "Bee animation 4.png M 


Storyboard storyboard = new Storyboard(); 

ObjectAnimationUsingKeyFrames animation = new ObjectAnimationUsingKeyFrames(); 
Storyboard.SetTarget(animation, image); 

Storyboard.SetTargetProperty(animation, new PropertyPath("Source")); 


TimeSpan currentlnteval = TimeSpan.FromMilliseconds(0); 
foreach (string imageName in imageNames) { 

ObjectKeyFrame keyFrame = new DiscreteObjectKeyFrame(); 
keyFrame.Value = CreatelmageFromAssets(imageName); 
keyFrame.KeyTime = currentlnteval; 
animation.KeyFrames.Add(keyFrame); 
currentlnteval = currentlnteval•Add(interval); 


storyboard.RepeatBehavior = RepeatBehavior.Forever; 
storyboard.AutoReverse = true; 
storyboard.Children.Add(animation); 
storyboard.Begin(); 


This key -Pv-amc 
\ a^imaiio^ -flips 

■the a^ima*kio^ -Pvamcs 
•to make the \>tts 
wi 呼 -flap. 


private static Bitmaplmage CreatelmageFromAssets (string imageFilename) { 

return new Bitmaplmage(new Uri( M /Assets/ M + imageFilename, UriKind.RelativeOrAbsolute)); 


you are here ► 
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O 6125AT5 TH5 VI5WM^>D5L. 

The ViewModel layer consists of a single class, BeeAttackViewModel, 
which uses the methods, properties, and events in the Model to update 
the controls in the View. Create the ViewModel folder and add a 
BeeAttackViewModel class. Here’s the code for it: 


Solution 


using View; 

using System.Collections.ObjectModel; 
using System.Collections.Specialized; 
using System.ComponentModel; 
using System.Windows; 
using System.Windows.Controls; 
using System.Windows.Threading; 


class BeeAttackViewModel : INotifyPropertyChanged { 

public 工 NotifyCollectionChanged BeeControls { get 
private readonly ObservableCollection<BeeControl> 


TV>c V\t^i uses |*tcmspa^cl 

-to b'md 七 iVis dollct*t*ioy> o( 
^>ttCor\hro\ objcd*U *to 
0>ildvm of a Canvas, so i\\t 
Viow/l/lodcl tdiY\ add bees by 
uf *|*U _b«CoyrbroU -f ield- 

一 \l 


■ 

企 T o ▼泛 Q 葫 _ 

Search Solution Explorer (Ctrl+;) 

Solution 'BeeAttack' (1 project) 
^ 回 BeeAttack 

> A Properties 

> References 

> 国 Assets 

> ^ Model 
m Resources 
篇 View 

a 这 I ViewModel 

> Cl AoD.xaml 

Solution Explorer Class View 


<> 


P 

p 


▲ 


> 

> 


return —beeControls; } } 

beeControls 

=new ObservableCollection<BeeControl>() 


public Thickness FlowerMargin { get; private set; } 
public Thickness HiveMargin { get; private set; } 
public int MissesLeft { get { return 一 model•MissesLeft; 
public int Score { get { return —model•Score; } } 
public Visibility GameOver { get; private set; } 


private Size beeSize; 
private readonly Model.BeeAttackModel —model = new Model.BeeAttackModel(); 
private readonly DispatcherTimer —timer = new DispatcherTimer(); 
private double —lastX; 

private Size _playAreaSize { get; set; } 
private Size _hiveSize { get; set; } 
private Size flowerSize { get; set; } 


飞 These fvofcv-tics av-c bou^d *to 

of -flov/CV* dr>d illVC images, SO 七 he 
V'\t^iModt\ Uv\ move them 3ir>d 
by ufda 七 ’•％ 七 he 七 av\d a 

Pv-ofcv-tyCKaia^cd cvcv>*t. 


public BeeAttackViewModel() { 

—model.Missed += MissedEventHandler; 

—model•GameOver += GameOverEventHandler; 
model.PlayerScored += PIayerScoredEventHandler; 



TKc ViowModcl keeps a rc(trtv\U b> 

3y\ *ms*tar>dc o( Model m d fv-Wa*tc 
-f ield- Here’s *i*t hooks uf rU 

cvcr>*t ^av>dlcv-s (or Models events. 


timer.Tick 


HiveTimerTick; 


GameOver = Visibility.Visible; 
OnPropertyChanged("GameOver"); 


The 1/icwModcl d\rca*tcs 


public void StartGame (Size flowerSize 
flowerSize = flowerSize; 
hiveSize = hiveSize; 
playAreaSize = playAreaSize; 
beeSize = new Size(playAreaSize. 
model.StartGame(flowerSize.Width 


,Size hiveSize, 


Size 


playAreaSize) { 


each ^>ttCoy\hro\ sets 
"the height wid*th ； so 
_七 ^ccds a sizjC -Pov- 七 hat. 


Width / 10, playAreaSize.Width / 10); 

, beeSize•Width, playAreaSize•Width, hiveSize.Width); 


OnPropertyChanged("MissesLeft M ); 


_timer.Interval = _model.TimeBetweenBees; 
_timer.Start(); 

GameOver = Visibility.Collapsed; 
OnPropertyChanged("GameOver"); 


The \/*icv/ CdiY\ siav*t by dallm^ *tV>c 

\/*ic>mA 1 odcl^s S'tavt^a^cO passm^ *i*t 

k 七 he siz.es -the Kivc, a^d play area ta^s. 

TKc ViowModcl scis *iis private fields, slar-b *tKc 
timer, a^A ufdates *rb ^amcOvcv f\rofC\rty- 


840 


Chapter 17 












M "the usev sv/ipcs, 七 he viev/s 
Ma^ipula-tio^DcIta cve^-t -Piv-cs, a^d 
its cvcir>*t ha^dlcv- dal Is -this method 

"to update 七 he -Pioy/cv^s lodd'tioh- 



public void ManipulationDelta(double newX) { 
newX = —lastX + newX * 1.5; 

if (newX >= 0 && newX < (—playAreaSize•Width - 
—model.MoveFlower(newX); 

FlowerMargin = new Thickness(newX, 0, 0, 0); 
OnPropertyChanged("FlowerMargin"); 
lastX = newX; 


build a windows phone game 



flowerSize.Width)) { 


private void GameOverEventHandler(object 
_timer.Stop(); 

GameOver = Visibility.Visible; 
OnPropertyChanged ("GameOver M ) ; 4—- 


sender, EventArgs e) { 

⑶ ds, 七 he ^lowModcl siofs *i*b a^A ufdaics 

一 rts pvofcvty ； v/hith is bouv>di *to *tV>C \/*is*ibil'i*tY 

S-tadkPav>cl W\i\\ i\\t Ovcv Tc^tBlodk, button 釙 d Imk. 


private void MissedEventHandler(object sender, EventArgs e) { 
OnPropertyChanged("MissesLeft M ); 


void HiveTimerTick(object sender, EventArgs e) 
if ( 一 playAreaSize•Width <= 0) return; 

double x = —model.NextHiveLocation (); 

HiveMargin = new Thickness(x, 0, 0, 0); 
OnPropertyChanged("HiveMargin"); 


Evcv-y -time the tirwcv- \/ic>wModld asks -the 

< /Wodcl -Pov- 灼 wt hive lodatio^ dr\dl -fives o-Pf d new 

bee by d\rea*tn^ a ^>ttCoY\bro\ addm^ i-t b> *thc 
__bccCo^*tv*ols observable dollcdtio^ v/hidh dauses rt "bo 
jet added ho *thc play av-ea Ca^vas^s Childv-c^. 


BeeControl bee = new BeeControl(x + hiveSize.Width / 2 , 0 , 

playAreaSize.Height + 一 flowerSize•Height / 3 , BeeLanded); 

bee.Width = beeSize.Width; 
bee.Height = beeSize.Height; 
beeControls.Add(bee); 


private void BeeLanded(object sender, EventArgs e) 
BeeControl landedBee = null; 

foreach (BeeControl sprite in beeControls) { 

if (sprite.FallingStoryboard == sender) ^ 
landedBee = sprite; 


—model•BeeLanded(Canvas.GetLeft(landedBee)); 
if (landedBee != null) beeControls.Remove(landedBee); 


A delegate to the BeeLanded method is passed 
into the BeeControl, which adds it to the falling 
animation storyboard’s Completed event — so when 
it fires, the sender is set to the Storyboard object. 
The BeeControl’s FallingStoryboard property 
returns a reference to that Storyboard object 
so the ViewModel can use it to look up the correct 
BeeControl in its beeControls collection. 


public event PropertyChangedEventHandler PropertyChanged; 
private void OnPropertyChanged(string propertyName) { 

PropertyChangedEventHandler propertyChanged = PropertyChanged; 
if (propertyChanged != null) 

propertyChanged(this, new PropertyChangedEventArgs(propertyName)); 


private void PlayerScoredEventHandler(object sender, EventArgs e) { 
OnPropertyChanged("Score"); 

timer.Interval = model.TimeBetweenBees; A 


l/Vhcr>cvcv i\\t flayer sdoves, 

timcv is updated usmj 七 he Model’s 

- T*imcBcWcir>BcCS p\ropc\rty *to 
make -the 50 a little *fas*tcv-. 


you are here ► 
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6125AT5 TH5 eeeArracK^aMeCoNr^L lO MANAGE TH5 WH^>U5 ^AM5. 

The View has one more thing in it. BeeAttackGameControl has the Image controls for the hive and the 
flower, the Canvas for the bees to fall down, and the controls that are displayed when the game is over (including 
a Button to start the game). Add a new 


to the View folder. Here’s the XAML: 



called BeeAttackGameControl.xaml 


<Grid x : Name= M LayoutRoot M Background= M SkyBlue M > 


<Grid.RowDefinitions> 

<RowDefinition Height= M * M /> 
<RowDefinition Height= M 10* M / > 
<RowDefinition Height= M 2* M /> 
</Grid.RowDefinitions> 



〈Image x : Name= M hive M 


you dv-catc d ^cv/ iVi^dov/s Phone usc\r -the IVB adds i 七 

>wi 七 h a 的 erwp-ty 今 vid earned Layou-tRoo-t- Charge its Badkyou^d -to 
Sky Blue ar^d Jive i-t "thv-cc v-oy/s ： 七 he "top v-ow -fov- -the hive image, 七 he 
middle v-ow (or the play av~ed ； 扣 d 七 he bottom v-ov/ -Pov- -the \ *lov/cv- 


Source= M /Assets/Hive (outside).png" 
HorizontalAlignment= M Left M 

Margin= M {Binding HiveMargin} M /> - 

CItemsControl Grid.Row= M 1 M x : Name= M playArea M > 

<ItemsControl 工 temsSource= n {Binding BeeControls 


TliC hive has its Mavj'm 

bou^d *to *thc \/ieWV1odel’s 
ttivcMav-^m fv-ofcv-*ty. 

> 


CItemsControl•ItemsPanel> 

<ItemsPsnelTemplate> 
<Canvas/> 

</ItemsPanelTemplate> 
</ItemsControl• 工 temsPanel> 
</ItemsControl> 

</ItemsControl> 


This ItemsCohWs (-tcmsSouv-dc is bound 
■to the observable CoWttho^ o( BeeCcmU 
objects ih -the 1/icwModcl, so tBC\\ 乙 。士 ol jets 

added the Canvas m the ItcmsPahdT^plalc. 


Top M > 


<TextBlock Grid.Row= M 1 M Foreground= M Black" VerticalAlignment= 
<Run>Misses left : </Run> 

<Run Text= M {Binding MissesLeft} M /> 

</TextBlock> 


<TextBlock Grid.Row= M 1 M Foreground= M Black" VerticalAlignment= M Top" 

Hor i z on ta 1 Alignment= M Right M Text= M {Binding Score}’’ 
Style= M {StaticResource PanoramaltemHeaderTextStyle} M /> 

〈Image x : Name= M flower M 

Source= M /Assets/Flower.png M 
Grid.Row= M 2 M 

HorizontalAlignment= M Left M 
Margin= M {Binding FlowerMargin} M /> 



<StackPanel Grid.Row=' 


VerticalAlignment= M Center' 



These Tc^tBlodks show 
•the flayer s stove 
the number o-P misses 
bc-fovc the jamc Cl^ds. 


The \/iewModel’s 
fv-ofCV-ty a Visibility 

so it be bou^d div-cdtly 
b> d )<A^U- Visibility property. 


HorizontalAlignment= M Center M Visibility^"{Binding GameOver} M > 

<StackPanel Orientation= M Horizontal M HorizontalAlignment= M Center M > 

<TextBlock Foreground="Yellow" 

Style= M {StaticResource JumpListAlphabetSmallStyle} M >Bee</TextBlock> 
<view : BeeControl Width= M 75 M Height= M 75 M /> 


The dlidk cvc^-t ha^dlcv -fov this bu*bto 灼 


You y\tt& the 

>Cm|^S*vicv/ <TextBlock Foreground= M Black" 

hd 你 espddC mavkuP Style= M {StaticResource JumpListAlphabetSmallStyle} M >Attack</TextBlock> 

11 I </StackPanel> 

oy \ t-nC 

-PoV* this ImC- |*t 〈Button Click= M Button Click M >Start a new game</Button> — . . .. . i » . i u 丄， 

dv*dws d -Plapfmj IS m 七 & dodc—benmd oy\ *tnc 

• /1 <HyperlinkButton Content= M Learn how to build this game" 

tt OY\ X, t. NavigateUri= M http : / / www. headfirst labs . com/hfc sharp" 

TargetName= M blank" / > 

</StackPanel> 

</Grid> 
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build a windows phone game 


Next, add an xmlns : view property and a ManipulationDelta event 
handler to the <UserControl> tag at the top of the XAML file. Start by 
putting your cursor just before the closing > bracket on line 10 and hitting Enter 
to add a line, then start typing xmlns : view=" " — as soon as you hit the 
quotation mark, an IntelliSense window will pop up to complete the namespace: 



爾 Ins : view: 


B 3 


http://schema&.mic rosoft. com/cli ent/2007 
htt:p://sc hema&.inic rosoft. co m/exp ressio n/blen d/ZOOS 
htt:p://sc hema&.mic rosoft. co m/wi nfx/2006/xaml 
htt:p://sc hem as. op enxmlfo rm ats.o rg/ma rku p-compatibil ity/2006 
BeeAttack (BeeAttack] 

BeeAttack.Model (BeeAttack) 

BeeAttack.Resources. (BeeAttack) 


BeeAttack.View (BeeAttack) 



Choose the \/icy/ 

-Pv-om 七 he dv-op-dov/r>. \( you 
a pirojed 七 

you’ll sec 七 hat project 

灼 a … e ms-tcad c^P 

•m 七 he y/ihdov/. 


n 3 B eeAtt a c k. Vi ewM □ d el (BeeAttack) 


Hit Enter again and start typing ManipulationDelta=" " to add the event handler. The 
IDE will pop up an IntelliSense window to add a new event handler method to the code-behind: 


xmlns ^ view= 11 clr-namespace : BeeAtt ack. View 1 " 
ManipulationDelta= " 


<New Event Handler 〉 


When you’re done, you’ll have these two additional lines in the opening <UserControl> tag: 

xmlns : view= n clr-namespace:BeeAttack.View" . 

^ — 

ManipulationDelta="UserControl 一 ManipulationDelta" 


1 ( the IVB does〆 七 

pop up -the l^-tclliSc^sc 
wmdov/s (ov some v-casoh, 
you just -type 
ihese I'mes r^a^ually- 


Finally, open BeeAttackGameControl.xaml.es and add the code-behind. 

Here’s the code for it: 

using ViewModel; 


public partial class BeeAttackGameControl : UserControl { 

private readonly ViewModel.BeeAttackViewModel viewModel 


new ViewModel.BeeAttackViewModel(); 


public BeeAttackGameControl () 
工 nitializeComponent (); 


DataContext 


viewModel; 


4^ 


The dojvbrol hds dn 
o( -the \/icv/Modcl 

object, ^iW\cM i-t uses -Pov- i-ts 


private void Button Click (object sender, RoutedEventArgs e) { 


viewModel.StartGame(flower.RenderSize, hive.RenderSize, playArea.RenderSize); 


The S*ta\rt bu*t*to^ dal Is -the 
\/icv/Modcrs Stav-t^amcO method, 
v/ f>ass'm^ the si«s -that the 

^ \/icv/A1 odd i^ccds as 


private void UserControl 一 ManipulationDelta(object sender, 


System.Windows.Input.ManipulationDeltaEventArgs 
viewModel.ManipulationDelta(e.DeltaManipulation.Translation.X); 


The A1a^ipula*tio^Pcl*ta ewt ha^dlcv dalls 
strai^rt thv-oujh *to *thc \/ieWVWel’s method. 


you are here ► 
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bonus project 



UPDATE TH5 MAIN PA^B TO ADD TH5 d^AM5 


Now that we’ve encapsulated the entire game behind the BeeAttackGameControl, we just 
need to add it to the main page. Open MainPage.xaml and add the xmlns : view namespace 
to the <phone : PhoneApplicationPage> opening tag, just like you did with the 

opening tag in BeeAttackGameControl.xaml. * ^ 

/igaih, i+ you used a di4+cv-cht 

the holrwcspadc will rwol-Uh youv 

o( BccAtta^k. 


xmlns : view= ▼▼ clr-namespace : BeeAttack. View' 




instead o( 


Next, find the Grid named GontentPanel and add your BeeAttackGameControl 
to it. Put your cursor between the opening and closing tags, start typing <view: to 
pop up an IntelliSense window, and select BeeAttackGameControl: 


< I - -ContentPan€I - place additional content here -- ■> 

<Grid x :: ame = "ContentPane1 1F Grid. Row= l, l 1F Ma rgi n = 11 12^@ j 12 j @ 1B > 
<view : 


</ 6 rid> 


^jb! eeAttackGarneCc ntrcl 


O BeeControl 


Here’s what the XAML should look like after it’s added: 

<!--ContentPanel - place additional content here--> 

<Grid x : Name= n ContentPanel" Grid.Row= M 1" Margin= n 12,0,12,0 n > 

<view : BeeAttackGameControl/> 

</Grid> 



Congratulations — your game works! 

As soon as you update the MainPage.xaml file, you should 
see your game’s start page show up in the designer 
window. Now you can run the game in the emulator or 
on the device.. .and you can get creative by expanding the 
game! 

* Try adding bonus bees that are worth more, or 
evil bees that the player must avoid. 

* Make some of the bees fly side to side by adding 
(Canvas . Left) animations. 

* We included a “hive interior” image file. Gan you 
think of something cool to do with it? 

* Claim your bragging rights by publishing 
your code on GodePlex, GitHub, or another social 
code sharing site... and then let other readers 
know about it on the Head First C# forum: 

http:/ / www.headfirstlabs.com/hfcsharp. 


844 


Chapter 17 
















appendix i ： le-ftQVers 

The top 




% 




things we wanted 





to include in this book 


I'M STIUU HUKl^EY 

M0IS51 




The fun’s just beginning! 

We've shown you a lot of great tools to build some really powerful software with C#. But 
there’s no way that we could include every single tool, technology, or technique in this 
book — there just aren’t enough pages. We had to make some really tough choices about 
what to include and what to leave out. Here are some of the topics that didn’t make the 
cut. But even though we couldn’t get to them, we still think that they’re important and 
useful, and we wanted to give you a small head start with them. 


this is an appendix 




microsoft helps you 


# 1. There's so much more to Windows Store 

Looking to learn more about programming Windows Store apps? Microsoft 
has some fantastic resources to help you learn. The first step is downloading 
the Windows 8 Camp Training Kit, which has presentations, samples, links 
to really useful resources, and most importantly, a set of hands-on labs 
that teach you about everything from capturing data from a device’s camera 
to adding live tiles and push notifications to your apps. You can download the 
installer for the Windows 8 Gamp Training Kit here: 

http:/ / www.microsoft.com/ en-us/download/ details.aspx?id=29854 

Once you install it, you’ll get a set of web pages, media files, and presentations, 
as well as documentation and source code for the hands-on labs. It’s a great next 
step for continuing to get G# concepts into your brain. 


@01 


C:\Win8CS\Default.htm 


P- c 


虐 Windows 8 Training Kit 


tl Windows* 


名 ; dpe 




Welcome to Windows 8 Camp in a box 

Windows Camps are free trainings to jumpstart your Windows Store app development. You can find a camp near you via our 
registration site: http://www.devcamps.ms/windows. 

'Windows Camp in a box" is an off-line version of the resources we use for our camps. This kit includes the hands-on-labs, presentations, 
samples (with source), and links to additional resources. 

Once you have completed and polished your app, attend an application excellence lab to get a developer token to submit your app to 
the Windows store. 


Happy Windows 8 coding! 

Let us know how we are doing at win8tlcfb@microsoft.com 
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n 


Ooti 


C:\Win8CS\Labs.htm 


p- c 


逵 Windows 8 Training Kit 




ft Windows* 

Hands-on - labs 


l^dpe 



Working with data: Listiviews and data binding 

In this lab you will become familiar with the basic anatomy of a Windows Store app. By the end of the lab, you will complete 
making a request to a REST service to get recipe data that will be displayed in the screen using a data-bound listview. 


Lab (HTML) 

■ 

Lab (docx) 

■ 

Source Code 


Optimizing your views: Orientation, snapping and semantic zoom 

In this lab, you will improve the Contoso Cookbook views by handling orientation, snapping, and adding semantic zoom to easily 
navigate through our recipe data. 


Lab (HTML) 

■ 

Lab (docx) 

■ 

Source Code 


Working with contracts: Search and share 

In this lab, you will implement the Share (Source) and Search contracts to seamlessly integrate with other applications and the core 
OS. 


Lab (HTML) 

■ 

Lab (docx) 

■ 

Source Code 


Media capture 

In this lab you will capture photos and video so you can brag about your favorite recipe creations to your friends using the Share 
contract you implemented in the previous lab. 


Lab (HTML) 

■ 

Lab (docx) 

■ 

Source Code 


Lifetime management: saving and restoring state 

In this lab you will learn about the process life-time management events in a Windows store app. You will save data in the 
suspending event, and restore it in the launching event so that the users have a seamless experience as the app’s lifetime is 
managed by the OS. 


Lab (HTML) 

■ 

Lab (docx) 

■ 

Source Code 


Settings and Preferences 

In this lab you will wire up a settings screen for Contoso Cookbook. You will save and restore roaming settings and seamlessly 
integrate with the Operating system's settings charm. 


Lab (HTML) 

■ 

Lab (docx) 

■ 

Source Code 


Tiles and push notifications 

In this lab you will pin recipes to the start screen, use local notifications to create timers, and leverage Windows Notifications 
Services (WNS) to send badges to our Contoso Cookbook app. 


Lab (HTML) 

■ 

Lab (docx) 

■ 

Source Code 


you are here ► 
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some basic stuff you want to know 

# 2. The basics 


Wc v/ish we dould jive this material -the same k'md 
thov-ough we wcv-c able "to p\rovidc *tWou^ou 七 

■the book, bu*t v/C jus*t didn't have pays -to do i*t ： 

But V/C still to yve you a jood s-tav-tmj pomt av\d < 
pladc *to Jo (ov more 'm-po\rma*tio^. 


Before we get started, here’s a Guy class that we’ll be using throughout this appendix. Take a look at how it’s 
commented. Notice how the class, its methods, and its properties are all commented with triple-slash (/ / /) 
comments? Those are called XML comments, and the IDE will help you add them. Just type “///’’ right before a 
class, method, property, or field declaration (and a few other places, too), and the IDE will fill in the skeleton of the 
XML comment for it. Then later, when you go to use the property, method, etc., the IDE will display information 
from the XML comments in its IntelliSense window. 


Ill <summary> 

III A guy with a name, age and a wallet full of bucks 
III </ summary> 
class Guy 


The )(ML -fov a dlass do^sis-ts 

of a <summa 浐 y> blodk. No-tidc how i-t 

sta\rb v/i-th <surwma\ry> av\d ends v/i-th 
</ Suminr\d\ry>. 


卜 


* Notice how Name and Age are properties with backing fields that are 

* marked readonly . That means those backing fields can only be set when 

* the object is initialized (in their declarations or in the constructor). 

V 


III <summary> 

III Read-only backing field for the Name property 
III </ summary> 

private readonly string name; 


III <summary> 

III The name of the guy 

III </ summary> 

public string Name { get 



a -field vcadoyjy is a useful 
-tool -fov c^dapsulatio^, because *i*t 

medv>s 七 ha 七 -field y>cvc\r be 
or>dc *tV>c objcd*t is *ms*tair>tia*tcd- 


return name 


III <summary> 

III Read-only backing field for the Age property 

III </ summary> 

private readonly int age; 


Youll lea^ about *tV>c 'readonly 
keyv/ov-d m Chaftc^r l^>, but v/a^i 
-to make suve you kr>ov/ wha 七 you vc 
look— at m case you -flip *to 七 his 
C3v-|icv- m 七 he book. 


Ill <summary> 

III The guy's age 
III </ summary> 

public int Age { get { return age; } } 

卜 

* Cash is not readonly because it might change during the life of the Guy. 

V 

III <summary> 

III The number of bucks the guy has 
III </ summary> 

public int Cash { get; private set; } 
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leftovers 


III 

III 

III 

III 

III 

III 


<summary> 

The constructor sets the name, age and cash 
</summary 〉 


W\\cy\ -the IDE adds 七 he skeleton (or 
d do^s-t\rud-to\r oy a^oihev- me 七 hod, i 七 
/ adds <pa\ram> tags -fov cath o( 七 he 
pav-amc-tcv-s. 


<param name="name">The name of the guy</param> 


<param name="age">The guy's age</param> 

<param name="cash">The amount of cash the guy starts with</param> 


public Guy(string name, int age, int cash) { 


this.name = name; 


this.age 二 age; 
Cash = cash; 


public override string ToString() { 

return String.Format("{0} is {1} years old and has {2} bucks". Name, Age , Cash); 

} 


ttevVs v/cVc ovcv-v*id*m^ 
"IoS*tv*m^O. This is dovcvcd *m 
Chapter 


III <summary> 

III Give cash from my wallet 
III </ summary> 

III <param name="amount M >The amount of cash to give</param> 

III <returns>The amount of cash 工 gave, or 0 if 工 don't have enough cash</returns> 
public int GiveCash(int amount) { 

if (amount <= Cash && amount > 0) 

{ 

Cash -= amount; 
return amount; 

} 

else 

{ 

return 0; 

} 

} 


III <summary> 

III Receive some cash into my wallet 
III </ summary> 

III <param name= M amount">Amount to receive</param> 

III <returns>The amount of cash received, or 0 if no cash was received</returns> 
public int ReceiveCash(int amount) { 
if (amount > 0) 

{ 

if (amount > 0) 

{ 

Cash += amount; 
return amount; 

} 

Console.WriteLine("{0} says : {1} isn't an amount 工 'll take ”， Name, amount); 

} 

return 0; 


you are here ► 
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some more basic stuff 


more basics. 


It’s easy to get overwhelmed when learning any computer language, and G# is no exception. That’s why we 
concentrated on the parts of the language that, in our experience, are most common for novice and intermediate 
developers. But there’s some basic G# and .NET syntax that’s really useful, but are a lot easier to approach at your 
own speed once you’re used to things. Here’s a console application that demonstrates some of it. 


static void Main(string[] args) 


// We'll use these Guy and Random instances throughout this example. 
Guy bob = new Guy("Bob", 43, 100); 


r 


Guy joe = new Guy ( n Joe ， ' ， 41, 100); 
Random random = new Random(); 


A vcdlly ^ood v/3y *to S handle or> *tv>is IS *to debu^ i*t 

av>d use v/a*tdhcs -to see v/V>aVs As you 50 iWou 吵七 he 

book, 七 vy >wrth some *tKcsc doy>dCf*b. 



people say 


七 ha 七 






arc 


bad fv-adtidc. 
Thcvc arc 


bf^taW/ o*tKcv- 
y/ays 七 “a 七 you 
ddr> achieve 
the same 
vcsults. Bu*t 
•rt’s usc-ful *to 
kr>o>w 1 io>m ttcy 
y/ovk \y\ tasc 


you v*uir> 

七 hem. 


advoss 


TV bveak 
s*t3*tcw\cr\*t 
dduses 七 he loop 
*to ehd) a^d 
fvo^vam 
■to move *bo 
*tiic Console- 
iVirrteLmeO 
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卜 

* Here are two useful keywords that you can use with loops. The "continue" keyword 

* tells the loop to jump to the next iteration of a loop, and the "break" keyword 

* tells the loop to end immediately. 


The break, continue, throw, and return statements are called "jump statements" 
because they cause your program to jump to another place in the code when they're 
executed. (You learned about break with switch/case statements in Chapter 8, and 
the throw statement in Chapter 10.) There r s one more jump statement, goto, which 
jumps to a label. (You'll recognize these labels as having very similar syntax 
to what you use in a case statement.) 

You could easily write this next loop without continue and break. That's a good 
example of how C# lets you do the same thing many different ways. That's why you 
don't need break, continue, or any of these other keywords or operators to write 
any of the programs in this book. 


* The break statement is also used with "case"which you can see in Chapter 8. 

V 


while (true) { 

int amountToGive = random.Next (2 0); 


// The continue keyword jumps to the next iteration of a loop 
// Use the continue keyword to only give Joe amounts over 10 bucks 


if (amountToGive < 10) < 

continue; 


The dor\tmuc statement causes -the pv-ojv-am -fco jump ovcv- 
v-cs-t o-P -the i-tcvatio^ ba^k -bo -the -top o-f -the loop. 


// The break keyword terminates a loop early 



(joe.ReceiveCash(bob.GiveCash(amountToGive)) 
break; 


== 0 ) 


Console.WriteLine("Bob gave Joe {0} bucks, Joe has {1} bucks , 
amountToGive, joe.Cash, bob.Cash); 


Console • WriteLine ( "Bob's left with {0} bucks，，，bob . Cash); 


Bob has {2} bucks". 


Appendix i 









leftovers 


// The ?: conditional operator is an if/then/else collapsed into a single expression 
// [boolean test] ? [statement to execute if true] : [statement to execute if false] 
Console. WriteLine ("Bob {0} more cash than Joe ，，， 

bob. Cash > j oe. Cash ? "has" : "does not have ’'）； 


// The ?? null coalescing operator checks if a value is null, and either returns 
// that value if it's not null, or the value you specify if it is 
// [value to test] ?? [value to return if it r s null] 


bob 二 null; 

Console.WriteLine("Result of ?? is 




/ / Here's a loop that uses goto statements and labels . It's rare to see them, but 
// they can be useful with nested loops. (The break statement only breaks out of 
// the innermost loop) 
for (int i = 0; i < 10; i++) 


for (int j = 0; j < 3; j++) , , i. 

{ T\\t 50-to sta 七加⑼七 dauscs c^cdutio^ 

if (i > 3 ) ^ div^6*tly "to a label. 

goto afterLoop; 

Console.WriteLine("i = {0}, j = {1}", i, j); 

} } A label is a s-tv-'ma o( Irttcv-s, i^umbcv-s, 

afterLoop : u^dcv"Sfi.o\rcs, follov/ed by d dolors- 


// When you use the = operator to make an assignment, it returns a value that you 
// can turn around and use in an assignment or an if statement 


int a; 

int b = (a = 3 * 5); 

Console.WriteLine("a = {0}; b = {l}; n . 


b); 


TV_s sta-tcrwCht -Pilrs-t sets a 七 o S 决弓 , 
ihen sets b -to -the result ’ 


// When you put the ++ operator before a variable, it increments the variable 
// first, and then executes the rest of the statement. 

a = ++b * 10; ^_ _ ++b means i\\ai b 

Console.WriteLine ("a = { 0 }; b = {1};’ ，， a, b) ; -fiyst, ar\d a is sc*t *to b ^ 10. 

// Putting it after the variable executes the statement first and then increments 
a = b++ * 10; 

Console . WriteLine ("a = { 0 }; b = {l}; n , a, b) ; -tha-t -ri\rs-t d is set *to b ^ 

lO, av\d b is 


卜 


* When you use && and || to do logical 

* that as soon as the test fails, they 

* evaluated, if A is true then (A || B) 

* And when (A && B) is being evaluated, 

* be false no matter what B is. In both 

* because the operator doesn't need its 

V 


tests, they n short-circuit" -- which means 
stop executing. When (A || B) is being 
will always be true no matter what B is. 
then if A is false then (A && B) will always 
of those cases, B will never get executed 
value in order to come up with a return value 


you use / 氺 氺 / *to add 

tow>w>cy\*b, you do 灼’七 ^avc *to add 

a ^ a*t 

wt rb makes easier -to vead 


f 


int x 
int y 
int z 



Well use -these values -the Code 
the pajc! 


OY\ 


you are here ► 
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even more basics 


Us'mj -the lojidal W o\r W a^d “and” opcva-fco\rs ； shovt-divduitmg 

properties is a^othcir way you eah c-f^cdtivcly y/vi-tc av\ i-P/dsc 
S't^'tcrwCht This is *tlic same 3s sdyih^ “only c^cdu^tc (y / x. 二二午） 
i-f (y < zJ is "brue. \ 


// y / x will throw a DivideByZeroException because x is 0. But since (y < z) is true, 
// the || operator knows it will be true without ever having to execute the other 
// statement, so it short-circuits and never executes (y / x == 4) 


if ((y < z) I I (y / x == 4)) 

Console.WriteLine("this line printed because 


short-circuited"); 


// Since (y > z) is false, the && operator knows it will return false without 
// executing the other statement, so it short-circuits and doesn't throw the exception 
if ((y > z) && (y / x == 4)) 

Console.WriteLine("this line will never print because && short-circuited"); 


/* 

* A lot of us think of 1 ' s and 0 ' s when we think of programming, and manipulating 

* those 1 r s and 0 r s is what logic operators are all about. 

V 


// Use Convert.ToString() and Convert•ToInt32() to convert a number to or from a 
// string of 1 r s and 0 r s in its binary form. The second argument specifies that you're 
// converting to base 2. 

string binaryValue = Convert•ToString(217, 2); 
int intValue 二 Convert.ToInt32(binaryValue, 2); 

Console.WriteLine("Binary {0} is integer {l} n , binaryValue, intValue); 


// The & , 

|, A , and 〜 operators are 

logical 

AND, OR, XOR, and bitwise comp 

lement 

int vail = 

Convert.ToInt32( n 100000001 n 

,2); 

The lo^i^al opcv-a*tov-s f, \, A av-c bui 

l*t—m OY\ dll the 


int val2 
int or = 
int and : 
int xor : 
int not : 


Convert•ToInt32 ( "001010100" f 2) 
vail I val2; 

: vail & val2; 

=vail a val2; 

: 〜 vail; 



^uw\CV"i£. types，all Churns, dhd bool. The o^ly 
between f ff | ||) oy\ bool is 

that these do 灼’七 sho\rb—div-duit 


* is lojidal oy\ m-tcjv-al r>umcv-i£. -types a^d 

Chums, y/hidh, m a way, is a^alo^ {o ! \oy bool. 


// Print the values -- and use the String • PadLeft () method to add le 


Console 

Console 

Console 

Console 

Console 

Console 


.WriteLine("vail : { 0} 
.WriteLine("val2 : {0} 
.WriteLine(" or: {0} 
.WriteLine(" and : {0} 
.WriteLine(" xor : { 0} 
.WriteLine(" not : {0} 


wading 


Convert.ToString(vail, 2)); 

Convert.ToString(val2 , 2) .PadLeft(9, ' 0 ^)); 

Convert•ToString(or, 2) .PadLeft(9, ' 0')); 

Convert•ToString(and, 2) .PadLeft(9, ' 0 A )); 

Convert.ToString(xor, 2) .PadLeft(9, ' 0 A )); 

Convert•ToString(not, 2).PadLeft( 9, y 0 r )); 


// Notice what the 〜 operator returned : 11111111111111111111111011111110 

// It's the 32-bit complement of vail : 00000000000000000000000100000001 
// The logical operators are operating on int, which is a 32-bit integer. 



vc*tuv^s a 

objcd*t> a 灼 d 

wc vc 

PadLef 七 0 method 
oy \ 七 ha 七 objcd*t *to 
pad *tV>c v-csul*t ou 七 

>wi*th ZjCV-oCS. 


This will mdke B lo*b stY\St when you \ru^ the proyaw' and look 
a*t the output. Rcmcmbcv-, you do 灼’七 r\ttd {o m all o*f this 
dodc — you tar\ download ii all -fv-om the Head riv-st Labs wcbsitcl 

h*btp://>ww>w.hcad*fiv"s*tlabs. 乙 ow\/books/lvfdshdV"p 
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// The « and » operators shift bits left and right. And you can combine any 
// logical operator with =, so »= or &= is just like += or *=• 
int bits = Convert•ToInt32( n ll n , 2); 
for (int i = 0; i < 5; i++) 

{ 

bits «= 2; 

Console•WriteLine(Convert•ToString(bits, 2) •PadLeft(12, '0 ^)); 


for (int i = 0; i < 5; i++) 



Console . WriteLine (new Guy ( "Harry"47, 376). ToString ()); 


// We've used the + operator for string concatenation throughout the book, and that 
// works just fine. However, a lot of people avoid using + in loops that will have 
// to execute many times over time, because each time + executes it creates an extra 
// object on the heap that will need to be garbage collected later. That's why .NET 
// has a class called StringBuilder, which is great for efficiently creating and 
// concatenating strings together. Its Append () method adds a string onto the end, 
// AppendFormat() appends a formatted string (using {0} and {1} just like 
// String.Format() and Console.WriteLine() do), and AppendLine() adds a string 
// with a line break at the end. To get the final concatenated string, call 
// its ToString() method. 


StringBuilder stringBuilder = new StringBuilder("Hi "); 
stringBuilder.Append("there f "); 


stringBuilder.AppendFormat("{0} year old guy named {1}. ", joe.Age, joe.Name); ^ — ^ 
stringBuilder .AppendLine ("Nice weather we^re having .")； iW ^ ^ ^ | 

Console.WriteLine(stringBuilder.ToStrinq()); r 丄 . or , 

., •• … n u » ^ Stv-rngbuildcv pcvWms y/ovsc +, because + 

You typidally use S 七叫 Build 饮 wbjou 刀釗 七个七 e ^ o( ad 


Console.ReadKey() 


do^*t k^ov/ m ddvd 的 de *thc 

do^^a*tc^a*tio^s you v/a^*t *to pc\r-fo\rm. 


will p\rc-dorwputc the ICi^jtn 

-rijuirc out how mudh 


rwerwovy -to allodatc- 


卜 

* This is a good start, but it's by no means complete. Luckily, Microsoft gives you 

* a reference that has a complete list of all of the C# operators , keywords, and 

* other features of the language. Take a look through it -- and if you A re just getting 

* started with C #, don't worry if it seems a little difficult to understand. MSDN 

* is a great source of information, but it's meant to be a reference, not a learning 

* or teaching guide. 

* 

* C# Programmer Reference : http :/ /msdn.microsoft.com/en-us/library/618ayhy6.aspx 

* C# Operators: http : //msdn.microsoft.com/en-us/library/6a71f45d.aspx 

* C# Keywords: http : //msdn.microsoft. com/en-us/library/x53aQ6bb.aspx 
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some assembly required 


Namespaces and assemblies 

We made the decision to focus this book on the really practical stuff you need to know in order to build and run 
applications. Throughout every chapter, you create your projects in Visual Studio and run them in the debugger. We 
showed you where your compiled code ended up in an executable, and how to publish that executable so that other 
people can install it on their machines. That’s enough to get you through every exercise in this book, but it’s worth 
taking a step back and looking a little closer at what it is that you’re building. 

When you compile your G# program, you’re creating an assembly. An assembly is a file that contains the compiled code. 
There are two kinds of assemblies. Executables (occasionally called “process assemblies”）have the EXE file extension. All of 
the programs you write in this book are compiled as executables. Those are the assemblies that you can execute (you know, 
EXE files you can double-click and run). There are also library assemblies, which have the DLL file extension. They contain 
classes that you can use in your programs, and, as you’ll see shortly, namespaces play a big role in how you use them. 

You can get a handle on the basics of assemblies by first creating a class library, and then building a program that uses 
it. Start by opening Visual Studio 2012 for Desktop and creating a new Glass Library project called Headfirst. 
Csharp . Lef tover3. When the library is first created, it contains the file Class . cs. Delete that file and add a new 
class called Guy. cs. Open up the new Guy. cs file: 

namespace Headfirst.Csharp.Leftover3 

{ 

class Guy 


Notice how Visual Studio made the namespace match your class library name? That’s a very standard pattern. 

Go ahead and fill in the Guy class with the code from leftover #2 — we’ll use it in a minute. Next, add two more 
classes called HiThereWriter and LineWriter. Here’s the code for HiThereWriter: 

namespace Headfirst.Csharp.Leftover3 

{ 

public static class HiThereWriter 

{ 

public static void HiThere(string name) 

{ 

MessageBox.Show("Hi there! My name is " + name); 


And here’s the code for LineWriter (it’s also in the Headfirst. Csharp . Leftover 3 namespace): 

internal static class LineWriter { 

public static void WriteALine(string message) 

{ 

Console.WriteLine(message); 


We named the class library 
Headfirst.Csharp.Leftover3 
because that’s a pretty standard 
way of naming assemblies. Read 
more about assembly naming here: 
http://msdn.microsoft.com/en-us/ 

Iibrary/ms229048.aspx 


You can also create class libraries in Visual 
Studio for Windows 8. We asked you to create 
this project in the Desktop edition because 
all of the Framework assemblies are already 
referenced, so the “Add Reference” window 
that we show on the facing page will be empty. 
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leftovers 


Now try to compile your program. You’ll get an error: 


Error List 





T - 

O 1 Error 

! 0 Warnings 

0 0 Messages 

Search Error List 

P- 


Description 


Rle 


Line 


Column 


Project 


▲ 


The name 'MessageBox' does not exist in the cuFrent context Guy,cs 


Headfirst. CsharpXeftover3» 


OK, no problem — we know how to fix this in a Desktop app. Add a line to the top of your class: 
using System.Windows.Forms; 


Wait, it still doesn’t compile! And something’s weird here. When you typed in that line, did you notice that when you 
got as far as “using System.Win” the IntelliSense window stopped giving you suggestions? That’s because your project 

hasn’t referenced the System. Windows . Forms assembly. 


Let’s fix this by referencing the correct assembly. Go to the Solution Explorer and expand the “References” folder in 
your project. Right-click on it and choose “Add Reference … a window should pop up: 


Reference Manager - Headfirst.Csharp.Leftover3 


J Assemblies 


Targeting: .NET Framework 4.5 


Framework 

Extensions 

Recent 

P Solution 

l> COM 

Browse 


Name 

System.Web.Extensions.Design 
System.Web.Mobile 
System.Web.RegularExpressions 
System .Web.Routing 
System.Web.Services 
System.Windows 
System.Windows.Controls.Ribbon 

: 

System.Windows.Forms.DataVisualization 
System.Windows.Forms.DataVisualization.Des 
System.Windows.Input.Manipulations 
System .Wind ows.P resentation 
System .Wo rkf I ow. Activities 
System.Workflow.ComponentModel 
System .Wo rkf I ow.Runtime 
System .Wo rkf I owServices 
System .Xa ml 

0 System.Xml 

0 System.Xml. Li nq 

System .Xm I.Serial ization 

UlAutomationClient 

UI Auto mationClientsideP rovi ders 

UlAutomationProvider 

UlAutomationTypes 

WindowsBase 

Wind ows Formslntegration 

XamIBuildTask 



Search Assemblies (Ctrl+E) 

Name: 

System.Windows.Forms 
Created by: 

Microsoft Corporation 
Version: 

4.0.0.0 
File Version: 
4.0.30319.17929 built by: 
FX45RTMREL 


p ， 


Browse... OK Cancel 



This window is showing you 
the assemblies your program 
can access. Some of them are 
stored in the Global Assembly 
Cache (GAC), but not every 
assembly in the GAC shows 
up in this window. The GAC is 
a central, machine-wide set of 
assemblies that all of the .NET 
programs on the computer 
can access. You can see all of 
the assemblies in it by typing 
%systemroot%\ 
Microsoft.NET\assembly 
into the Search box on the 
Start page (or Start/Run for 
older versions of Windows). 


On the .NET tab, start typing “System.Windows.Forms” 一 it should jump down to that assembly. Make sure it’s 
highlighted and click OK. Now System. Windows . Forms should show up under the References folder in the 
Solution Explorer — and your program compiles! 

The “Add References” window figures out which assemblies to display by checking 
a registry key, not the GAC. For more info: http://support.microsoft.com/kb/306149 
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so that’s why we did that! 


.so what did I just do? 


Take a close look at the declarations for LineWriter and HiThereWriter: 
public class HiThereWriter 

internal static class LineWriter 


There are access modifiers on the class declarations: HiThereWriter is declared with the public access 
modifier, and LineWriter is declared with the internal one. In a minute, you’ll write a console application that 
references this class library. A program can only directly access another class library’s public classes — although they can 
be accessed indirectly, like when one method calls another or returns an instance of an internal object that implements 
a public interface. 

Now go back to your Guy class and look at its declaration: 
class Guy 


Since there’s no access modifier, it defaults to internal. We’ll want to expose Guy to other assemblies that reference 
this one, so change the declaration to be public: 

public class Guy 


Next, try running your program in the debugger. You’ll see this error: 


Microsoft Visual Studio Express 2012 for Windows Desktop 




A project with an Output Type of Class Library cannot be started 
directly. 

In order to debug this project, add an executable project to this solution 
which references the library project Set the executable project as the 
startup project, 


OK 


That makes sense when you think about it, because a class library doesn’t have an entry point. It’s just a bunch of 
classes that other programs can use. So let’s add an executable program that uses those classes — that way the debugger 
has something to run. Visual Studio has a really useful feature that we’ll take advantage of next: it can load multiple 
projects into a single solution. Right-click on the Solution in the Solution Explorer and choose Add >> New 
Project... to bring up the usual Add Project window. Add a new console application called MyProgram. 


Once your new program’s added, it should appear in the Solution Explorer right under the class library. Right-click on 
References underneath MyProgram, choose “Add reference …” from the menu, expand ^ Solution, and click 
on Projects. You should see your class library project listed 


Headfirst. Cshar 


Make sure it’s checked. It 


should now appear in the Solution Explorer when you expand “References” under your MyProgram project. 
Next, go to the top of your new project’s Program. cs file and start adding this using line: 


using Headfirst.Csharp•Leftover3; 



y\eMs uf w CsV^av-f ； ay\d 
w Lc-f*tovcv^ ;， as youVc 
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Now we can write a new program. Start by typing Guy. Watch what pops up: 
static void Main(string[] args) 


Guy 


class H ea dfi rst. Csha rp.Leftover2.Guy 


A guy with a nam^ age and a wallet full of bucks 


The IntelliSense window lists the entire namespace for Guy, so you can see that you’re 
actually using the class that you defined in the other assembly. Finish the program: 


static void Main(string[] args) 


Guy guy = new Guy( n Joe n , 43, 125); 
HiThereWriter.HiThere(guy.Name); 


Now run your program. Oh, wait — you get the same error message as before, because 
you can’t run a class library! No problem. Right-click on your new My Program 
project in the Solution Explorer and choose 0 Set as StartUp Project. Your 
solution can have many different projects, and this is how you tell it which one to start 
when you run it in the debugger. Now run your program again — this time it runs! 


building a "Hello World" program from the command line 


There's a tradition in programming called Hello World: a program that just prints one 
line of text (“Hello World”). This is typically the first program you’ll write in a new 
language, because if you can do that it proves that your tools work well enough to 
run more complex programs. The Developer Command Prompt is installed with 
Visual Studio 2012, and when you run it the G# compiler csc.exe is in your path. Run 
the Developer Command Prompt, then try using Notepad to create Hello World, cs ， 
using csc.exe to build an executable, and then running that executable: 


Developer Command Prompt for VS2012 


x 


C : \Users\Public\Docunents>type HelloUorld.es 
using System ； 
class HelloUorld 

public static void Main<string[] args> < 
Console.UriteLine< ,p Hello Uorld ,p > 

> 

> 


C ： \Users\Public\Docunents>csc HelloUorld.es 

Microsoft <R> Uisual Ctt Compiler version 4.0.30319.17929 

for Microsoft .NET Framework 4.5 

Copyright <C> Microsoft Corporation. All rights reserved 


C ： \Users\Public\Docunents>HelloUorld.exe 
Hello World 

C:\U s e rs\Pub1ic\Do c une n t s >_ 


leftovers 


Throughout the book we tell you 
that you compile your code. When 
you do, it’s compiled to Common 
Intermediate Language (IL), the 
low-level language used by .NET. 

It’s a human-readable assembly 
language, and all .NET languages 
(including G# and Visual Basic) 
are compiled into it. The IL code 
is compiled into native machine 
language when you run your 
program using the CLR’s just-in- 
time compiler, so named because 
it compiles the IL into native code 
just in time to execute it (rather than 
pre-compiling it before it’s run). 

That means your EXEs and 
DLLs contain IL, and not native 
assembly code, which is important 
because it means many languages 
can compile to IL that the GLR 
can run — including Visual Basic 
.NET, F#, J#, managed G++/GLI, 
JScript .NET, Windows PowerShell, 
IronPython, Iron Ruby, and more. 
This is really useful: since VB.NET 
code compiles to IL, you can build 
an assembly in G# and use it in a 
VB.NET program (or vice versa). 

If you have a Macintosh or Linux 
box, try installing Mono. It’s an 
open source implementation of 
IL that runs EXE files that you’ve 
built on the PC (typically by typing 
“mono MyProgram.exe” 一 but this 
only works on some .NET assemblies). 
We’re not going to talk any more 
about that, though, because this 
book is focused on Microsoft 
technology. But we do have to 
admit that it is pretty cool to see 
the Go Fish game or Hide and Seek 
running natively on Mac or Linux! 


We’re just scratching the surface of assemblies. There’s a lot more (including versioning and signing them for 
security). You can read more about assemblies here: http://msdn.microsoft.com/en-us/library/k3677y81.aspx 
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# 4. Use PackgrouwdWorkcr to make your WiwForms responsive 


Throughout the book, we’ve shown you a few ways that you can make your programs do more than one thing at a time. In 
Chapter 2, you learned about how to use the Application . DoEvents () method to let your form respond to button 
clicks while still in a loop. But that’s not a good solution (for a bunch of reasons we didn’t get into), so we showed you a 
much better solution in Chapter 4: using a timer to trigger an event at a regular interval. Later on, you learned how ot use 
a sync, await, and Task. An alternative to asynchronous methods is threading, but it can be very tricky and can lead to 
some very nasty bugs if you’re not careful. Luckily, .NET gives you a really useful component called BackgroundWorker 
that makes it easier to let your program use threads safely. 


Here’s a simple project to help you understand how BackgroundWorker works. Start by building this form. You’ll 
need to drag a CheckBox onto it (name it useBackgroundWorkerCheckbox), two buttons (named goButton 
and cancelButton) and a ProgressBar (named progressBar 1). Then drag a BackgroundWorker onto 
the form. It’ll show up in the gray box on the bottom of the designer. Keep its name backgroundWorkerl, and set its 
WorkerReports Progress and Wor ker Support sCance 11 at ion properties to true. 


Wtrts Badkyou^dl/Vov-kcv- 
domfoy>Cy>*t. No*t*idC V>o>w *rt 
ov>ly has a fvofcvtics 

-that you tav\ set 


4 BackgroundWorker Example 


n 


x 


Forml.cs [Design] 



qlJ BackgroundWorker example 

Use BackgroundWorker 


Go! 


Cancel 


i] 



]=「 


fi 3 b ac kg ro u ndWorker! 


Select the BackgroundWorker and go to the Events page in the Properties window (by clicking on the lightning- 
bolt icon). It’s got three events: DoWork, ProgressChanged, and RunWor ker Completed. Double-click on 
each of them to add an event handler for each event. 


Properties ▼ D 


backg rou nd Wor ker 1 System .Compon entM odel.Backgroun dWo rker 


SI ： f 


□ Asynchronous 


DoWork 


ProgressChanged 
Ru nWorkerC ompl eted 


bac kg rou nd Workerl _DoWork v 

b^ckg rou nd Worker 1 _Prog ressCha mqed 
backgrou nd Workerl _Ru nWorkerilom pleted 


DoWork 

Event handler to be run on a different thread when the operation begins. 


The code for the form is on the next two pages. 
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III <summary> 

III Waste CPU cycles causing the program to slow down by doing 
III </ summary> 

private void WasteCPUCycles() { 

DateTime startTime = DateTime.Now; 
double value = Math.E; 

while (DateTime.Now < startTime.AddMilliseconds(100)) 
value /= Math.PI; 
value *= Math.Sqrt(2); 

} 



calculations for 100ms 

TKc 1/Vas-tcCPUCydlcsO docs a 
>mV)oIc of ma-tKcmatidal 
taltula*tior>s *to *tic up 七 he 
CPU -foV lOO milliseconds, 

av\d *tKcir> *i*t vc*tuvy>s. 


)// 


<summary 〉 

III Clicking the Go button starts wasting CPU cycles for 10 seconds 
III </ summary> 

private void goButton—Click(object sender, EventArgs e) { 
goButton.Enabled = false; 

if (!useBackgroundWorkerCheckbox.Checked) { 

// If we're not using the background worker, just start wasting CPU cycles 


bd^k^\rouy\d 

y/o\rkcV", i*t 

enables 
bu*t*to» 


for (int i = 1; i <= 100; i++) 
WasteCPUCycles(); 
progressBarl.Value = i; 

} 

goButton.Enabled = true; 
else { 

cancelButton.Enabled = true; 


)// 


七 he usev- dlidks oy\ "the 6{o\ bu'ttoh, 七 he 
cvc^*t ha^dlcv- dhcdks -fco sec i-P 七 he u Usc 
Badkjvouhdl/Vbv-kcv^ is l-P i-t 

is〆 七 the (o \rnr» y/^s^tes CPU dydlcs -Poir 10 sedohds. 

I-P i-t is, He -Pov-m dal Is -the Badkyou^dlA/bykcv-^s 
Ruhl/Vo\rkcv/\syr>d() method ho tell it ho s-fcairt do'm^ 
its y/o\rk m -the badk^irouhd- 
// If we are using the background worker, use its RunWorkerAsync() 

// to tell it to start its work 

backgroundWorkerl. RunWorkerAsync (^new Guy ("Bob", 37, 14 6)); 

WhtY\ you tell a 七 wov-k, you jive it by\ 

I 的 this 乙 asc, wcVc f>ass'm^ i*b a 今 uy object (sec lc-f*tovcv- 4=1 -fov- its dc-f'mi*tio^). 



<summary 〉 

III The BackgroundWorker object runs its DoWork event handler in the background 
III </ summary> 

private void backgroundWorkerl_DoWork(obj ect sender, DoWorkEventArgs e) { 

// The e.Argument property returns the argument that was passed to RunWorkerAsync() 
Console . WriteLine ( "Background worker argument : " + ,(e .Argument ? ? "null")); 

Wtrt 


tteme s a jood example ol' how -to use ihc ?? m\\ doalesdmj opcvaW v/c talked 
abou 七 *m Ic-f-fcovcir #/. c 


// Start wasting CPU cycles 

for (int i = 1; i <= 100; i++) { , A . 

WasteCPUCycles () ; 'rctuir^s 

// Use the BackgroundWorker.ReportProgress method to report the % complete 

backgroundWorkerl.ReportProgress(i )； 


is null, "this \rctu\nr>s \ull^ o-thcirv/isc i't 







type safe 


The Ba^k^\rou^dlVb\rkcv- OY\\y -fives i*ts Pv-ojv-cssCha^Jcd d^d Ru^lVo\rkcv-Cow\plc*tcd events i-f 
i*ts lVov-kc\rRcpo\rtsPv-oa\rcss lVo\rkcv-Suppo\rtsC3^dclla*tioir\ pvopc\rtics a\rc *bruc. 

Ill <summary> 

III BackgroundWorker fires its ProgressChanged event when the worker thread reports progress 
III </ summary> 

private void backgroundWorkerl_ProgressChanged(object sender, ProgressChangedEventArgs e) { 
progressBarl.Value = e.ProgressPercentage; 


^ l/Vhc^ -the DolVov-k cvc^-t handler dalls -the Pv-ojv-cssCha^^cdO method, 
i 七 causes -the Batkjvou^dlVbv-kcv- -fco vaisc i-ts Pv-ojvcssChahjcd cvc^t 


III 〈 summary 〉 and sc*t *bo "the pc\r£.c^*t passed ho it 

III BackgroundWorker fires its RunWorkerCompleted event when its work is done (or cancelled) 

III </ summary> 

private void backgroundWorkerl RunWorkerCompleted(obj ect sender, RunWorkerCompletedEventArgs e) 


goButton.Enabled = true; 
cancelButton.Enabled = false; 



W\\tY\ *thc y/o\rk is Complete, the Ru^Wo\rkcv-Complc*tcd CVC^*t 
\rc-ci^ablcs *thc 6\o\ but*ton BY\d disables -the Ca^cl bu*t*to^. 


Ill <summary> 

III When the user clicks Cancel, call BackgroundWorker.CancelAsync() to send it a cancel message 

l-P -the usev- t\\cMs i*t dal Is *thc 


Once you’ve got your form working, run the program. It’s easy to see how BackgroundWorker makes your program 
much more responsive: 

* Make sure the “Use BackgroundWorker” checkbox isn’t checked, then click the Go! button. You’ll see the 
progress bar start to fill up. Try to drag the form around — you can’t. The form’s all locked up. If you’re lucky, 
it might jump a bit as it eventually responds to your mouse drag. 

* When it’s done, check the “Use BackgroundWorker” checkbox and click the Go! button again. This time, the 
form is perfectly responsive. You can move it around and even close it, and there’s no delay. When it finishes, it 
uses the RunWorkerCompleted method to re-enable the buttons. 

* While the program is running (using BackgroundWorker), click the Cancel button. It will update its 
Cancellation Pending property, which will tell the program to cancel and exit the loop. 

Are you wondering why you need to use the ReportProgress () method rather than setting the ProgressBarl 
Value property directly? Try it out. Add the following line to the DoWork event handler: 

progressBarl.Value = 10; 

Then run your program again. As soon as it hits that line, it throws an 工 nvali dOper at ion Except ion with this 
message: “Cross-thread operation not valid: Control 'progressBarl 5 accessed from a thread other than the thread it was 
created on.” The reason it throws that exception is that BackgroundWorker starts a separate thread and executes the 
DoWork method on it. So there are two threads: the GUI thread that’s running the form and the background thread. One 
of the .NET threading rules is that only the GUI thread can update form controls; otherwise, that exception is thrown. 


Badkjv-ou^dlVbv-kcv-^s 

rwethod h> jive i-t *thc message -fco da^el- 


III </ summary> 

private void cancelButton_Click(object sender, EventArgs e) 

backgroundWorkerl.CancelAsync() ； ^ 


This is just one of the many threading pitfalls that can trap a new developer — that’s 
why we didn’t talk about threading anywhere in this book. If you’re looking to get 
started with threads, we highly recommend Joe Albahari’s excellent e-book about 
threading in C# and .NET: http://www_albahari.com/threading 
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# 5. The Type class and ftetTypeO 


One of the most powerful aspects of the G# programming language is its rich type system. But until you’ve got 
some experience building programs, it’s difficult to appreciate it — in fact, it can be a little baffling at first. But we 
want to give you at least a taste of how types work in G# and .NET. Here’s a console application that gives you an 
introduction to some of the tools you have at your disposal to work with types. 

We or>ly nxtr\hoY\td *rt bvic-fly, bu 七 
hevVs a vcrwmdcv you v>cs*t 
dldsses msidc o-f o*tKcv*. Pv-oyam 
doy>*ta*ms Ncs-tcdClass, v/V>*idh do 山 ms 
PoublcNcstcdClass. 


class Program { 

class NestedClass { 

public class DoubleNestedClass 
// Nested class contents 



s 

the Chtv-y 
poiht... 


static void Main (string[] args) 




Type guyType = typeof (Guy); 

Console.WriteLine("{0} extends {l} n , 
guyType. FullName, 
guyType . BaseType . FullName); 

// output : TypeExamples.Guy extends System.Object 

Type nestedClassType = typeof(NestedClass.DoubleNestedClass); 
Console.WriteLine(nestedClassType.FullName); 

// output : TypeExamples.Program+NestedClass+DoubleNestedClass 

List<Guy> guyList = new List<Guy>(); 

Console . WriteLine (guyList. GetType () .Name); 

// output : List'1 


V°^ 匕 use -the keyv/ovd to a 

-type (like ^uy, \v\i, or DalcTi^c) \v\io a Type 
object 丁 he 灼 you -Pmd out its -Pull rtdme 
and base type i-f i-t did / 七 mhev-i-t -Pvorw 
i-ts base type is Sysicm.Objcdt). 



1/VI 你 you jet the type o( a 
its hanr»c is ihc type 
name -Polloy/cd by a badkv/av~d 
^uo^tc 3K>d "the hurwbev- of its 


This is "the 
Systcm.Typc^ 
dlass. The 
^ctTypcO 
method \rC*tuV"^s 

a Type object. 



Dictionary<string, Guy> guyDictionary = new Dictionary<string, Guy>(); 
Console.WriteLine(guyDictionary.GetType().Name); 

// output : Dictionary'2 

The Pull/N/arwC p\ropCV-*ty v/c 
used m the -Pivs-t pairt o( 
this is a nrte^bev* o( 

System. 亍 ype. 

_ _ _ _ _ 

Console . WriteLine ( " { 0 } - {l} n , intType . FullNameint32Type . FullName); 

// System.Int32 - System.Int32 


Type t = typeof (Program); 
Console.WriteLine(t.FullName); 

// output : TypeExamples.Program 

Type intType = typeof(int); 

Type int32Type = typeof ( 工 nt32); 


-floai is alias -fov 

dnd m 七 
•is a 灼 alias ?ov Sys-tcm. 
I 灼 * 13 Z. ThcyVc bo*tV> 
s*tvud*U (v/hidh you 
leaded all about m 
Chap 七饮 I 千 ). 


Console.WriteLine("{0} {l} n , float.MinValue, float.MaxValue); 
// output : -3.402823E+38 3.402823E+38 


Console.WriteLine("{0} {l} n , int.MinValue, int.MaxValue); 
// output：-2147483648 2147483647 


Numciric. value types 扣 d DaicTime have 
M'mViluc /Vl3^\/aluc pvopcv-tics -tha-t 
v-ctuv-i^ -the lov/cs-t hijhcs-t valid value 


Console.WriteLine("{0} {l} n , DateTime.MinValue, DateTime.MaxValue); 
// output : 1/1/0001 12:00:00 AM 12/31/9999 11:59:59 PM 

Console.WriteLine(12345.GetType().FullName); 

// output: System. Int32 ^ Litcvals have *tyfcs, bool you use 

Console • ReadKey () ; ^ctTypcO *to "those "types. 


There’s so much more to learn about types! Read more about them 
here: http://msdn.microsoft.com/en-us/library/ms1731 04.aspx 
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all things being equal 


# 6. Equality, lEquatabk and Equals!) 


Throughout the book, when you’ve wanted to compare values in two variables, you’d use the == operator. But you 
already know that all things being equal, some values are more “equal” than others. The == operator works just fine for 
value types (like ints, doubles, DateTimes, or other structs), but when you use it on reference types you just end 
up comparing whether two reference variables are pointing to the same object (or if they’re both null). That’s fine for 
what it is, but it turns out that G# and .NET provide a rich set of tools for dealing with value equality in objects. 


To start out, every object has a method Equals (), which by default returns true only if you pass it a reference to itself. 
And there’s a static method, Ob j ect. Ref erenceEquals ()，which takes two parameters and returns true if they both 
point to the same object (or if they’re both null). Here’s an example, which you can try yourself in a console application: 


Guy joel = new Guy( n Joe n , 37, 100); 

Guy j oe2 = j oel; 

Console.WriteLine(Object.ReferenceEquals(j oel, 
Console.WriteLine(j oel.Equals(joe2)); 

Console.WriteLine(Object.ReferenceEquals(null, 

joe2 = new Guy( n Joe n , 37, 100); 

Console.WriteLine(Object.ReferenceEquals(j oel, 
Console.WriteLine(j oel.Equals(joe2)); 



joe2)); 

// 

True 


// 

True 

null)); 

// 

True 

joe2)); 

// 

False 


// 

False 


Ag— wcVc usiha -the 
same 与 uy dhss 

I^W #/. 


But that’s just the beginning. There’s an interface built into .NET called 工 Equatable<T> that you can use to add 
code to your objects so they can tell if they’re equal to other objects. An object that implements IEquatable<T> 
knows how to compare its value to the value of an object of type T. It has one method, Equals () ， and you implement 
it by writing code to compare the current object’s value to that of another object. There’s an MSDN page that has 

r more information about it (http:/ / msdn.microsoft.com/en-us/library/ms 131190.aspx). Here’s an important excerpt: 

M* you doh’t 

do "this, "the ^ “If you implement Equals,you should also override the base class implementations of Object.Equals(Object) and GetHashCode 
匕 ompilev* will so that their behavior is consistent with that of the IEquatable< T>. Equals method. If you do override Object Equals (Object), 
give you a )our overridden implementation is also called in calls to the static Equals (System. Object, System. Object) method onyour class. 

wa^hihg. This ensures that all invocations of the Equals method return consistent results, which the example illustrates.” 

Here’s a class called EquatableGuy, which extends Guy and implements 工 Equatable<Guy>: 


III <summary> 

III A guy that knows how to compare itself with other guys 
III </ summary> 

class EquatableGuy : Guy, 工 Equatable<Guy> { 

public EquatableGuy(string name, int age, int cash) 

: base(name, age, cash) { } 


The E^uaUO mc*tV>od tompav-cs 
actual values m o*tKcv ^uy objed 七 
-f ields, his tJsmC, 

(Casii *to see i-f *tV>cyVc same by\A 
y or>ly *tv*uc i-f *t^cy av*c- 




III <summary> 

III Compare this object against another EquatableGuy 
III </ summary> 

III <param name="other">The EquatableGuy object to compare with</param> 

III <returns>True if the objects have the same values, false otherwise</returns> 
public bool Equals(Guy other) { 

if (ReferenceEquals(null, other)) return false; 
if (ReferenceEquals(this, other)) return true; 

return Equals(other•Name, Name) && other.Age == Age && other.Cash == Cash; 
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III <summary> 

III Override the Equals method and have it call Equals(Guy) 

III </ summary> 

III <param name="obj">The object to compare to</param> 

III <returns>True if the value of the other object is equal to this one</returns> 
public override bool Equals(object obj) { 

if (!(obj is Guy)) return false; 
return Equals((Guy)obj); 



/S Smdc ouv E^ualsO method alv"C5dy 
domfav-cs ^uys, wc II jusi ta\\ i*t- 


III <summary> 


1/VcVc also ovcv-v-idmg -the E^ualsO 
method "tha-t wc 'mhc\ri-tcd -fv-orw 
Object, as well as ^ciHashCodc 
(because o( the CoY\br^tt rwcr>-tio^cd 

•m 七 ha 七 MSVhl article). 


Ill Part of the contract for overriding Equals is that you need to override 
III GetHashCode() as well. It should compare the values and return true 


III if the values are equal. 

Ill </ summary> 

III <returns></returns> 
public override int GetHashCode() 
const int prime 二 397; 
int result = Age; 
result = (result * prime) 
result = (result * prime) 
return result; 


A 


A 


This is a pv-rtiy sta^dav-d 
-Pov- ^ctHashCodcO. hloic -the use 
i o( -the bitwise )(0R ( 八 ) opc^a*tov, a 

匕 p\rinr»c 灼 umbeV", dhd "the demdi 七 ioir^l 
opevaiov (?:). 

(Name != null ? Name.GetHashCode() : 0); 

Cash; 


And here’s what it looks like when you use Equals () to compare two EquatableGuy objects: 


j oel = new EquatableGuy("Joe" , 37, 100); 


j oe2 = new EquatableGuy("Joe" , 37, 100); 

Console.WriteLine(Obj ect.ReferenceEquals(joel, j oe2)); 

// 

False ) 

^uy.E^ualsO will ohly 

Console.WriteLine(joel.Equals(joe2)); 

// 

True L 

^tu\rh t\ruc i-P the 

joel.GiveCash(50); 

Console.WriteLine(joel.Equals(joe2)); 

// 

( 

False 

values o-p "the 
\ objects ohre the same. 

j oe2.GiveCash(50); 

Console.WriteLine(joel.Equals(joe2)); 

// 

True 



And now that Equals () and GetHashCode () are implemented to check the values of the fields and properties, the 
method List. Contains () now works. Here’s a List<Guy> that contains several Guy objects, including a new 
EquatableGuy object with the same values as the one referenced by j oel. 


List<Guy> guys = new List<Guy>() { 

new Guy( n Bob n , 42, 125 ), 
new EquatableGuy(joel.Name, j oel.Age 
new Guy( n Ed n , 39, 95) 


Console.WriteLine(guys.Contains(joel)); 
Console.WriteLine(joel == joe2); 



Listms() will *thv*oujh i*ts 

乙 orrt ⑶扣 d dal I obje^s 

E^ualsO method "fco dompdire i 七 wi 七 h 
*thc v-c-Pcv-cr\dc you pass "to i*t. 


True 

False 


"though joel ay>d joc 2 - fonrvt "to objects |sy/*t *t^CV*C somC*thnr>^ v/C d 3 r^ do dbou 七 

wrtii -the same values, —— and !— s*till dor^parc p|. a ^ oiA ^l 353 

I I 1 I J J w w r W 

-the v-clcv-c^tcs, y\ot the values themselves. 


some classes are more equal than others 


If you try to compare two E qua table Guy references with the == or != operators, they’ll just check if both references are 
pointing to the same object or if they’re both null. But what if you want to make them actually compare the values of the 
objects? It turns out that you can actually overload an operator — redefining it to do something specific when it operates 
on references of a certain type. You can see an example of how it works in the EquatableGuyWithOverload class, 
which extends E qua table Guy and adds overloading of the == and =! operators: 

III <summary> 

III A guy that knows how to compare itself with other guys 
III </ summary> 

class EquatableGuyWithOverload : EquatableGuy 

{ 

public EquatableGuyWithOverload(string name, int age, int cash) 

: base(name, age, cash) { } 


public static bool operator 


if (Object.ReferenceEquals(left, null)) return false; 
else return left.Equals(right); 


S'mdc v/c vc 
dlv-eddy dc-f mcd { 

\us 七 mvcvt 


public static bool operator 


return !(left 


right); 


public override bool Equals(object obj) 
return base.Equals(obj); 


(EquatableGuyWithOverload left, 
EquatableGuyWithOverload right) 

we used -- -to dhcdk -fov- hull 
you -Piguv-c out why? 

(EquatableGuyWithOverload left, 
EquatableGuyWithOverload right) 

v/c do 於 ’ 七 ovcv'V'idc ^^udlsO 

^c-tttas^CodcO, \Vt Will *^is y/avVnr^: 

^^ua-tablc^uy^Ov^loaa' •二二 

ov opev'a^tov f— bu*t docs ovcw^idc Object- 

^ctttasliCodicO. 


public override int GetHashCode() 
return base.GetHashCode(); 


Smdc 6<\ua*tablc^uyW'i*tii0vc\rload at*b 

just like E«\ua*tablc^uy v/c 

cav\ jus-t dall i\\t base mctiiods. 


Here’s some code that uses EquatableGuyWithOverload objects: 


joel = new EquatableGuyWithOverload(joel.Name 
j oe2 = new EquatableGuyWithOverload(j oel.Name 
Console.WriteLine(joel == joe2); // False 

Console.WriteLine (joel != joe2); // True 


,joel.Age, j oel.Cash); 
,joel.Age, j oel.Cash); 



iVait whai happened? 

It’s dall’mg 与 uy’s —— and 
二 ! opcvaWs. C^s-t -fco 
E<\uatablc^uyl/ViihOvcvload io 

all ihc toYYtt {, 二二 av\d —/ 


Console.WriteLine((EquatableGuyWithOverload)joel == 

(EquatableGuyWithOverload)joe2); 
Console.WriteLine((EquatableGuyWithOverload)joel != 

(EquatableGuyWithOverload)joe2); 

joe2.ReceiveCash(25); 

Console.WriteLine((EquatableGuyWithOverload)j oel == 

(EquatableGuyWithOverload)j oe2 ); 
Console.WriteLine((EquatableGuyWithOverload)j oel != 

(EquatableGuyWithOverload)j oe2); 


// True 
// False 

// False 
// True 
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# 7 Using yield return to create enumerable objects 


In Chapter 8 we learned about the 工 Enumerable interface and how it’s used by the foreach loop. G# and .NET 
give you some useful tools for building your own collections and enumerable types, starting with the 工 Enumerable 
interface. Let’s say you want to create your own enumerator that returns values from this Sport enum in order: 

enum Sport 

{ 

Football, Baseball, 

Basketball, Hockey, 

Boxing, Rugby, Fencing, 


You could manually implement IEnumerable yourself, building the Current property and MoveNext () method: 

class SportCollection : 工 Enumerable<Sport> { 

public 工 Enumerator<Sport> GetEnumerator() 
return new ManualSportEnumerator(); 

} 

System.Collections. 工 Enumerator System.Collections. 工 Enumerable•GetEnumerator() { 

return GetEnumerator (); 

} The Cir\umC\ra-toV- 

class ManualSportEnumerator : 工 Enumerator<Sport> { |£^umCV-a*tov-<Spov-*t>. The -Povcadh 

int current 二 -1; loof uses its Cu\r\rc^*t 

public Sport Current { get { return (Sport) current; } } a^d AlovcNc'X.'tO method- 
public void Dispose() { return; } // Nothing to dispose 

object System•Collections •工 Enumerator•Current { get { return Current; } } 


(Ehurwcvablc \ust dohtaihS ohC rwethod, 

/ bu"t wc ^Iso y\tt& bo build 

i/ ^l^ss -Po\r the Churwcv*a*fco\r i-fc vctuv-hS. 


public bool MoveNext() { 

int maxEnumValue = Enum.GetValues(typeof(Sport)).Length - 1; 
if ((int)current >= maxEnumValue) 
return false; 
current++; 
return true; 




Bv\d uses it -fco \rctuv-h the 

spov-t the 


public void Reset() { current 


0 ; 


Here’s a foreach loop that loops through ManualSportCollection. It returns the sports in order (Football, 
Baseball, Basketball, Hockey, Boxing, Rugby, Fencing): 

Console.WriteLine("SportCollection contents :")； 

SportCollection sportCollection = new SportCollection(); 
foreach (Sport sport in sportCollection) 

Console.WriteLine(sport.ToString()); 


That’s a lot of work to build an enumerator — it has to manage its own state, and keep track of which sport it returned. 
Luckily, G# gives you a really useful tool to help you easily build enumerators. It’s called yield return, and you’ll 
learn about it when you flip the page. 


Just a o-f somcth'rng -fv-om Chaptcv- l^' all 乙 olle 匕七 10 吣 av"C c^umc\rablc, but y\oi cvcv-ythmj 

ihats is a dollcdtio^ unless i-t implements -the ICollc^*tio^<T> Wc 

didn't show you how *to build dollcdtio^s -f\rom the you 灼 d up, but uir\dc\rs*ta^d'mj c^umcv-a-tors is 
dc-fmi-tcly bo you stav-ted dovm -that v-oad- 
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enumerate this! 

The yield return statement is a kind of all-in-one automatic enumerator creator. This SportCollection class 
does exactly the same thing as the one on the previous page, but its enumerator is only three lines long.: 


class SportCollection : 工 Enumerable<Sport> { 

System.Collections. 工 Enumerator System.Collections. 工 Enumerable•GetEnumerator() { 

return GetEnumerator(); 


public 工 Enumerator<Sport> GetEnumerator() { 

int maxEnumValue = Enum.GetValues(typeof(Sport)).Length - 1; 
for (int i = 0; i < maxEnumValue; i++) { 

yield return (Sport) i; Like v/c said earlier iW\s is jusi iht sia\ri -for d 

} V Spo\rtCollcd*tio^ ^Idss. Y 0 ^d s*ti|| io 

} *tlr»C I Col I cd*tio^<Spo\rt> 


That looks a little odd, but if you actually debug through it you can see what’s going on. When the compiler sees a 
method with a yield return statement that returns an 工 Enumerator or IEnumerator<T>, it automatically 
adds the MoveNext () and Current methods. When it executes, the the first yield return that it encounters 
causes it to return the first value to the f oreach loop. When the foreach loop continues (by calling the MoveNext ( ) 
method), it resumes execution with the statement immediately after the last yield return that it executed. Its 
MoveNext () method returns false if the enumerator method returns. This may be a little hard to follow on paper, but 
it’s much easier to follow if you load it into the debugger and step through it using Step Into (FI 1). To make it a little 
easier, here’s a really simple enumerator called NameEnumerator ( ) that iterates through four names: 

static 工 Enumerable<string> NameEnumerator() { 

yield return "Bob"; // The method exits after this statement ... 

yield return "Harry"; // ... and resumes here the next time through 
yield return "Joe"; 
yield return "Frank"; 


And here’s a foreach loop that iterates through it. Use Step Into (FI 1) to see exactly what’s going on: 

工 Enumerable<string> names = NameEnumerator(); // Put a breakpoint here 
foreach (string name in names) 

Console.WriteLine(name); 


There’s another thing that you typically see in a collection: an indexer. When you use brackets □ to retrieve an object 
from a list, array, or dictionary (like myList [ 3 ] or myDictionary [ "Steve" ]), you’re using an indexer. An 
indexer is actually just a method. It looks a lot like a property, except it’s got a single named parameter. 

The IDE has an especially useful code snippet. Type indexer followed by two tabs, and the IDE will add the skeleton 
of an indexer for you automatically. 

Here’s an indexer for the SportCol lection class: 

public Sport this[int index] { 

get { return (Sport)index; } 

} 

Passing that indexer 3 will return the enum value Hockey. 
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Here’s an 工 Enumerable<Guy> that keeps track of a bunch of guys, with an indexer that lets you get or set guys’ ages, 
class GuyCollection : 工 Enumerable<Guy> { 

private static readonly Dictionary<string, int> namesAndAges = new Dictionary<string, int>() 


Joe' 


41}, {"Bob", 43}, 


'Ed' 


39}, { n Larry n , 44}, {"Fred ", 45} 


public 工 Enumerator<Guy> GetEnumerator() { 

Random random = new Random(); 
int pileOfCash = 125 * namesAndAges.Count; 


The c^unr»cv-a*tov uses -this p\riva*tc Did-tio^avy 
"to keep tvadk o( juys i-tll dveate, bu-t 
it does / 七 actually dveate the 今 uy objects 
•bhci^sclvcs u^til its is used- 


int count = 0; 

foreach (string name in namesAndAges.Keys) { 

int cashForGuy = (++count < namesAndAges.Count) ? random.Next(125) : pileOfCash, 

pileOfCash -= cashForGuy; 

yield return new Guy(name, namesAndAges[name], cashForGuy) 

} I 七 dV"C3*tcs 与 uy objects y/i*th \rdr\dom amouir\*ts of ddsK- lAfeVc jus*t domj *tKis *to sKo>w 

-that *thc c^umcvaxov* tBY\ dv-catc objects -the -fly duirn^ a -fov-cadh loop. 


A 


System.Collections. 工 Enumerator System.Collections.IEnumerable•GetEnumerator() 
return GetEnumerator(); 


III <summary> 

III Gets or sets the age of a given guy 
III </ summary> 

III <param name="name M >Name of the guy</param> 

III <returns>Age of the guy</returns> 
public int this[string name] { 
get { 

if (namesAndAges.ContainsKey(name)) 
return namesAndAges[name]; 
throw new IndexOutOf RangeException (’'Name 

} 

set { TW.S v^as a sti atttssor 

if (namesAndAges . ContainsKey (name) ) - ^ u pda-tcs d or 

namesAndAges [name] = value; ^ adds a ^ ^ bo 


/ 


By\ mvalid \y\dc% is passed "to 
by\ mdexev*, i 七 -typically 七 hvows a 灼 


name 


was not found"); 


else 


namesAndAges.Add(name, value); 


And here’s some code that uses the indexers to update one guy’s age and add two more guys, and then loop through them: 

Console.WriteLine("Adding two guys and modifying one guy"); 
guyCollection["Bob"] = guyCollection["Joe"] + 3; 
guyCollection["Bill"] = 57; 
guyCollection["Harry"] = 31; 
foreach (Guy guy in guyCollection) 

Console.WriteLine(guy.ToString()); 
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refactoring is a great programming habit 


# 8. Refactoring 


The code examples on this page are from the 
downloadable GDI+ PDF that’s on our website: 

http://www.headfirstlabs.com/hfcsharp 


Refactoring means changing the way your code is structured without changing its behavior. Whenever you write a 
complex method, you should take a few minutes to step back and figure out how you can change it so that you make it 
easier to understand. Luckily, the IDE has some very useful refactoring tools built in. There are all sorts of refactorings 
you can do — here are some we use often. 

Extract a method 

When we were writing the control-based renderer for the GDI+ PDF, we originally included this foreach loop: 
foreach (Bee bee in world.Bees) { 


These -fouv 
lihes move d 
bttCov\bro\ -Pvorn 
the Field -Pov-rw ― 
ho the Hive -fov-rw. 


beeControl = GetBeeControl(bee); 
if (bee•InsideHive) { 

if (fieldForm.Controls.Contains(beeControl) ) { 

fieldForm.Controls.Remove(beeControl); 
beeControl.Size = new Size (40, 40); 
hiveForm•Controls.Add(beeControl); 
beeControl.BringToFront(); 

.else—if (hiveForm.Controls.Contains(beeControl)) 
hiveForm.Controls.Remove(beeControl); 
beeControl.Size = new Size (20, 20); 
fieldForm.Controls.Add(beeControl); 
beeControl.BringToFront(); 

} 

beeControl.Location = bee.Location; 



Ar\d these -Pouv 

[\Y\ts r»o\/e a 
^>ttCoY\hco\ 

七 he Hive -fov-m *to 
七 he Field 


One of our tech reviewers, Joe Albahari, pointed out that this was a little hard to read. He suggested that we 
extract those two four-line blocks into methods. So we selected the first block, right-clicked on it, and 
selected “Refactor >> Extract Method.. This window popped up: 


Wc *tyfcd 3 灼 ame 

-Pov* Y\t^i method. ^ 
\Mt dedided *to dal I i*t 

/l/lovcBccFvomPicldTfotti vc() 

because 七 1 ^七 fv-c*t*ty mudh 
desdvibes 七 i 兄 todt 



docs. 


OK Cancel 


The IVB ecammed 

■the Code -tha-t v/c 

selected -figured 
ou-t 七 hat _七 uses a 
^>ttCoY\{yo\ variable 

乙 dlled bccCo^-tvol, 

so it added ii as a 
pav-arwetev- -to -the 

method. 


Then we did the same thing for the other four-line block, extracting it into a method that we named 
MoveBeeFromHiveToField ( ) . Here’s how that foreach loop ended up — it’s a lot easier to read: 

foreach (Bee bee in world.Bees) { 

beeControl = GetBeeControl(bee); 
if (bee.InsideHive) { 

if (fieldForm.Controls.Contains(beeControl)) 

MoveBeeFromFieldToHive (beeControl); 

} else if (hiveForm.Controls.Contains(beeControl)) 
MoveBeeFromHiveToField (beeControl, bee); 
beeControl.Location = bee.Location; 
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Rename a variable 


Back in Chapter 3, we explained how choosing intuitive names for your classes, methods, fields, and variables 
makes your code a lot easier to understand. The IDE can really help you out when it comes to naming things in 
your code. Just right-click on any class, variable, field, property, namespace, constant — pretty much anything that 
you can name — and choose “Refactor >> Rename”. You can also just use F2, which comes in handy because 
once you start renaming things, you find yourself doing it all the time. 

We selected “beeControl” in the code from the simulator and renamed it. Here’s what popped up: 



This y/ihdoy/ lets you 

dhoosc a hcv/ 灼 amc ^ 

-Pov ihc i*tcrw. 
v-chamcd 七 his, say, -to 
u Bobbo w , ihc IVB 
y/ould Jo "thv-oujh -the 
CoAt a^d cvcvy 

single oCC\AYYty\tt of i*t 
■to u Bobbo w . 


Rename 


New name 



beeControl 


Location: 


Beeh ive_Si mulator. Ren derer.D rawB ee&O 


0 Preview reference changes 
□ Search in comments. 

I I Search in strings 


OK 


Cancel 


The IP£ docs a v-cally 
-thovou^h job o( 

|-p you \rc 灼 a dl3ss, i*t II 
cvcvy 

七 ha 七 mstar>*tia*tcs i*t OV uses 
i*t. You tBr\ dlidk oy\ 
odduv*v*c^dc o( 
a^ywheve'm todt) ar>d 

I *tKc IP£ will make 

cvcv-yy/hcv-c m youv 

pv-o^V*3m. 


Consolidate a conditional expression 


Here’s a neat way to use the “Extract Method” feature. Open up any program, add a button, and add 
this code to its event handler: 


private void buttonl_Click(object sender, EventArgs e) { 
int value = 5; 
string text = "Hi there"; 

if (value ==36 || text.Contains("there")) 

MessageBox.Show("Pow !")； 

} 

Select everything inside the if statement: value ==36 | | text. Contains ("there"). Then 
right-click on it and select “Refactor >> Extract Method..Here’s what pops up: 



Extract Method 


C%fV"CSSlO\T\ cvdluatcs *to 
d bool) so 

3 method 
V"C*tuV"\r\s d bool 3y\d 
veflate Conditional 
-test a dall *to 七七 
mC*t^od. 


New method name: 


NewMethod 


Preview method signature: 



Us sma\rt ehou^li 
"to -figu\rc out that 
•t should dv-catc 
a s-fca-tid method, 
sihde it doesh^t use 
-fields. 

The c%fv-css"ioy> uses *t>wo 
variables called value a 灼 d 
so -the IPE added 
pav-amc*tcv-s *to 七 he me 七 hod 

us'ma -those 

个. 

Ko*t oy>|y will 七 his make 
*tV>c toAt casicv *to vead, 
bu 七 r>o>w you VC 5©*t a 
t\v*i mc*tV>od 七 ha 七 you 
cby \ v-cusc clsc>wV>cv-cf 


you are here ► 


869 













































we 1 re sure there J s a superhero metaphor in here somewhere 


# 9. Ammymous types, anonymous methods, and lambda expressions 

G# lets you create types and methods without using explicitly named declarations. A type or method that’s declared 
without a name is called anonymous. These are very powerful tools — for example, LINQwouldn’t be possible 
without them. But it’s a lot easier to master anonymous types, anonymous methods, and lambda expressions once you 
have a firm grasp on the language. So we only briefly covered anonymous types, and anonymous methods or lambda 
expressions didn’t make the cut at all. Here’s a quick introduction, so you can get started learning about them. 

class Program { 

delegate void MylntAndString(int i, string s); 
delegate int CombineTwolnts(int x, int y); 

static void Main(string[] args) { 

卜 

* In Chapter 14, you saw how the var keyword let the IDE determine the 

* type of an object at compile time. 

* 

* You can also create objects with anonymous types using var and new. 

•k 

* You can learn more about anonymous types here : 

女 http : //msdn.microsoft.com/en-us/library/bb397 696. aspx 


// Create an anonymous type that looks a lot like a guy: 
var anonymousGuy = new { Name = "Bob", Age = 43, Cash = 137 }; 

// When you type this in r the IDE r s IntelliSense automatically picks up 
// the members -- Name, Age and Cash show up in the IntelliSense window. 
Console.WriteLine("{0} is {1} years old and has {2} bucks ", 
anonymousGuy•Name, anonymousGuy.Age, anonymousGuy.Cash); 

// Output: Bob is 43 years old and has 137 bucks 

// An instance of an anonymous type has a sensible ToString() method. 
Console.WriteLine(anonymousGuy.ToString()); 

// Output : { Name = Bob r Age = 43 r Cash = 137 } 


/* 

* In Chapter 15, you learned about how you can use a delegate to reference 

* a method. In all of the examples of delegates that you r ve seen so far, 

* you assigned an existing method to a delegate. 

■k 

* Anonymous methods are methods that you declare in a statement -- you 

* declare them using curly brackets { }, just like with anonymous types. 

■k 

* You can learn more about anonymous methods here : 

* http : //msdn.microsoft.com/en-us/library/0yw3tz5k.aspx 

V_ 
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// Here r s an anonymous method that writes an int and a string to the console. 

// Its declaration matches our MylntAndString delegate (defined above), so 
// we can assign it to a variable of type MylntAndString. 

MylntAndString printThem = delegate(int i , string s) 

{ Console.WriteLine("{0} - {1}", i, s) ; }; 

printThem (123, "four five six '，）； 

// Output : 123 - four five six 

// Here r s another anonymous method with the same signature (int r string ). 

// This one checks if the string contains the int. 

MylntAndString contains = delegate(int i, string s) 

{ Console.WriteLine(s.Contains(i.ToString())); }; 

contains(123, "four five six"); 

// Output: False 

contains (123, "four 123 five six '，）； 

// Output : True 

// You can dynamically invoke a method using Delegate . Dynamiclnvoke() r 
// passing the parameters to the method as an array of objects . 

Delegate d = contains; 

d•Dynamiclnvoke(new object[] { 123, "four 123 five six" }); 

// Output : True 


/* 

* A lambda expression is a special kind of anonymous method that uses 

* the => operator. It's called the lambda operator, but when you're 

* talking about lambda expressions you usually say "goes to" when 

* you read it. Here r s a simple lambda expression : 

女 

* (a, b) => { return a + b; } 

~k 

* You could read that as "a and b goes to a plus b n -- it A s an anonymous 

* method for adding two values. You can think of lambda expressions as 

* anonymous methods that take parameters and can return values. 

■k 

* You can learn more about lambda expressions here : 

* http : //msdn.microsoft . com/en-us/library/bb397687.aspx 

V 


// Here / s that lambda expression for adding two numbers. Its signature 
// matches our CombineTwolnts delegate, so we can assign it to a delegate 
// variable of type CombineTwolnts . Notice how CombineTwolnts r s return 
// type is int -- that means the lambda expression needs to return an int . 

CombineTwolnts adder = (a, b) => { return a + b; }; 

Console.WriteLine(adder(3, 5)); 

// Output: 8 

// Here's another lambda expression -- this one multiplies two numbers. 
CombineTwolnts multiplier = (int a, int b) => { return a * b; }; 

Console.WriteLine(multiplier(3, 5)); 

// Output : 15 


// You can do some seriously powerful stuff when you combine lambda 
// expressions with LINQ . Here^s a really simple example: 

var greaterThan3 = new List<int> { 1, 2, 3, 4, 5, 6 } .Where(x => x > 3); 

foreach (int i in greaterThan3) Console.Write("{0} ", i); 

// Output: 456 


Console.ReadKey(); 
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there’s so much more LINQ 


*10. LINQ to XML 


You’ve seen XML throughout the book as a format for files that represents complex data as text. The .NET 
Framework gives you some really powerful tools for creating, loading, and saving XML files. And once you’ve got 
your hands on XML data, you can use LINQ to query it. Add “using System. Xml. Linq; ’’ to the top of a file 
and enter this method that generates an XML document with some Starbuzz Coffee customer loyalty data. 


private static XDocument GetStarbuzzData() { 


XDocument doc = new XDocument( 

new XDeclaration ( n 1 • 0 , M utf-8" , "yes "), 

new XComment("Starbuzz Customer Loyalty Data") 

new XElement("starbuzzData", 



new XAttribute("storeName" f "Park Slope "), 
new XAttribute (’'location ”， ’’Brooklyn, NY "), 



扣 )<ML -file, ar>d iha-t mdudes )<ML 

•files you t^v\ vead wvi-tc us'm^ 
Da-taCoh-tv-ad-tScv-ialiicv-. 


new XElement("person", 

new XElement("personallnfo n , 


object 

M’s pa\rt o( -the System.) ( 你 I.Lm' 


new XElement("name ", "Janet Venutian "), 


new XElement("zip" f 11215 )), 
new XElement ( ， ’ favoriteDrink，，，"Choco Macchiato") 
new XElement( n moneySpent n , 255 ), 



new XElement (’'visits, 50)), 
new XElement("person ", 

new XElement("personallnfo n , 

new XElement("name ", "Liz Nelson "), 
new XElement ( n zip ， ' ， 11238)), 
new XElement("favoriteDrink" f "Double Cappuccino"), 
new XElement("moneySpent ", 150 ), 



new XElement ( "visits, 35)) 

new XElement("person ", 


new XElement (’'personallnf o '，， 

new XElement ( "name" , "Matt Franks ，'）， 
new XElement ( n zip，'，11217 )), 
new XElement("favoriteDrink" f M Zesty Lemon Chai"), 
new XElement (’'moneySpent ， ' ， 75 ), 
new XElement (’'visits, 15)), 
new XElement("person", 

new XElement("personallnfo n , 

new XElement("name ", "Joe Ng"), 
new XElement( M zip" f 11217 )), 
new XElement("favoriteDrink", "Banana Split in a Cup "), 
new XElement (’'moneySpent ， ' ， 60), 
new XElement ( "visits, 10)), 
new XElement("person ", 

new XElement (’'personallnf o '，， 

new XElement("name ", "Sarah Kalter "), 
new XElement( M zip" f 11215 )), 
new XElement("favoriteDrink" f "Boring Coffee "), 
new XElement (’'moneySpent ， ' ， 110 ), 
new XElement (’'visits, 15)))); 


return doc; 


Microsoft has a lot of great documentation about LINQ 
and LINQ to XML online. You can read more about LINQ to 
XML and classes in the System.Xml.Linq namespace here: 
http://msdn.microsoft.com/en-us/library/bb387098.aspx 
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Save and load XML files 


You can write an XDocument object to the console or save it to a file, and you can load an XML file into it: 
XDocument doc = GetStarbuzzData () ; 

Console.WriteLine(doc.ToString()); 、 ^^ 

doc.Save("starbuzzData.xml"); 

XDocument anotherDoc = XDocument.Load("starbuzzData.xml M ) 


七 objects LoadO av\d 
methods \rcad a^d wvi-tc )(/\/IL 

-Piles. A^d its ToSVmgO r^cihod 
^de^rs cvcirythihg ihsidc ii as ohc bia 


Query your data 

Here’s a simple LINQquery that queries the Starbuzz data using its XDocument: 

var data = from item in doc.Descendants("person 

select new { drink = item.Element("favoriteDrink").Value, 
moneySpent = item.Element("moneySpent").Value, 
zipCode = item• Element ( n personalInfo n )• Element ( n zip，'）• Value 

foreach (var p in data) /ou already lets y 


T\\t Pcstcr\da\r\*b0 method 

a b> Bv\ 

okjedt yo'A cav\ fluj 
矿吵七 m*to L|N^- 



ou ddll 

Console • WriteLine (p. ToString () ) ; methods a^d use as of the a^d 

七 hat works \rcally well with 七 he & 伙伙七 0 method. 

厂 ou can do more complex queries too: 

var zipcodeGroups = from item in doc.Descendants("person") 
group item.Element( n favoriteDrink").Value 
by item • Element (’'personallnfo，，）. Element ( M zip" ) . Value 
into zipcodeGroup 
select zipcodeGroup; 
foreach (var group in zipcodeGroups) 

Console.WriteLine("{0} favorite drinks in {l} n , 

group.Distinct().Count (), group.Key); 


V-ctulr^S dh 
)<Elcrwcr>i objedi, Bv\d 
you C^y\ use its p\ropcv-tics 

■fco dhe 匕 k spedi-fid values 
m youv- )(ML doC.umcy\i- 


Read data from an RSS feed 

You can do some pretty powerful things with LINQto XML. Here’s a simple query to read articles from our blog: 

XDocument ourBloq = XDocument.Load("http : //www.stellman-greene.com/feed M ); 

Console.WriteLine(ourBlog.Element("rss").Element("channel").Element("title").Value); 
var posts = from post in ourBlog.Descendants("item") 

select new { Title = post. Element ( "title" ) .Value, TiiC )<PoC.umCr\*bLo3dO w\C*t^od 

Date = post.Element("pubDate").Value}; 
foreach (var post in posts) 

Console.WriteLine(post.ToString()); 



several overloaded 6 oy\s*brudx>vs. TiVis 

oY\t pulls )<ML data -fv-om a URL. 


Cv-catc a new Console application make suve 
you^vc jot V'mj Sys-tcm.X^|.L'm^ w at the 
■top, type this ^ucv-y mto the /l/]a'mO wthod, 
3^d out i 七 pvnvts "to ^ohsole- 


lA/c used the URL ouv- blo5, Build ， 七七饮 以七愉 c . 
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same projects now on the desktop 
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Q 
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A 

Label 

m 
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m 
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Game Over 


Solution Explorer 

企 T o ▼ 泛 O _!) <> 

Search Solution Explorer (Ctrl+;) 

Solution 'WPF Save The Humans' (1 project) 
a 回 WPF Save The Humans 

> A Properties 

> References 
Q App.config 

> D App.xaml 

> MainWindow.xaml 


平 X 


P 



ha l/VPF 7°^ 

use )<AML design 

•forms ur\ y/mdows ms*tcad 
Jc -full-st\rccr\ fajes. 


50% - [A] s:s a: [ 5 ] P ◄ 

C3 Design fi EDXAML d 
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〈TextBlock Ho 「 izontalAlignment="Left" TextWrapping="Wrap" Text=" Avoid These" Ve 「 ticalAlignment="Top 


► 
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El 
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Error List 


<ContentControl Content= ,, ContentControl" HorizontalAlignment= 
</StackPanel> 

〈Canvas x : Nanve=' , playArea" Grid.ColumnSpan="3"> 

<Canvas.Background 〉 

<LinearGradientBrush EndPoint="0. 5,1" StartPoint="0. 5,0"> 
<GradientStop Color="#FFA640EE" Offset="0"/> 
〈GradientStop Color= ,, #FF87EE40" Off set= ,, l"/> 

</l inparfir'adipntRriJsh 》 


Left" VerticalAlignment="Top" Height = 


Properties 

— Name playArea 
Type Canvas 
Search Properties 
Arrange by: Category ▼ 


早 X 
f 


P 


)Message 


Description 


Search Error List 
Project ▲ 



A 


▼ Error List Output 



# 11. Windows rrcscwtatiow Foundation 

Throughout the book you’ve built projects using three different technologies: Windows Store apps in G# and XAML, 
Microsoft’s latest-generation platform for building visual applications; and two different kinds of desktop applications, 
Windows Forms apps and console apps. And you saw a fourth technology, Windows Phone apps in G# and XAML. 

There’s another technology for building desktop apps that’s supported by Visual Studio 2012 for Windows Desktop. 

It’s called Windows Presentation Foundation (WPF). Like Windows Store apps, it’s based on XAML, and it uses 
many of the same constructions and syntax: Grids, StackPanels, TextBlocks, static resources, data binding, and more. 

We would have loved to include WPF apps in this book, but we just didn’t have room. Luckily, we have other options 
for helping you learn. You can go to http:/ / www.headfirstlabs.com/hfcsharp and download the WPFLearner } s 
Guide to Head First C#, a PDF guide that will walk you through building WPF versions of many of the Windows 
Store apps in this book, starting with Save the Humans from the first chapter. 

Pow't have Windows S? Pow't worry! You caw still do most of the projects iw WPF. 

Then you definitely want to download that PDF, because you’ll be able to use it as an alternate learning path for 
chapters 1,2, and 10 through 16, and return to rebuild the projects as Windows Store apps once you’ve upgraded. And 
even if you do have Windows 8, it’s still a good idea to go back and rebuild the projects as WPF desktop applications. 

WPF Save The Humans - Microsoft Visual Studio Express 2012 for Windows Desktop Quick Launch (Ctri+Q) p _ □ x 

FILE EDIT VIEW PROJECT 旦 UILD DEBUG TEAM DESIGN FORMAT I00LS TEST WINDOW HELP 

O ， - ►Start’ Debug - Any CPU ▼ 摩； _ 


Look closely at the -toolbox—it's 
9 0 "t -farwiliav* o-f 匕 oirbrols... 


-ahd iUt \rcst o-P the IDB looks 
adts aUosi exactly the 


Most o( the XAML torrbrols 

the same, have -the 
same pvopeirties … but tlicv-c av-c 
drf mrtely some di-f-Pcvc^dcs. 


Document Outline Data Sources 
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Pid you know that C # awd the .NET Framework caw. 


* Give you much more power over your data with advanced LINQ queries? 

* Access websites and other network resources using built-in classes? 

* Let you add advanced encryption and security to your programs? 

* Create complex multithreaded applications? 

* Let you deploy your classes so that other people can use them? 

* Use regular expressions to do advanced text searching? 


★ And a whole lot more! You’ll be amazed at how powerful G# can be. 



The Definitive Reference 


IN A NUTSHELL 



There’s a great book that explains it all! 

It’s called C# 5.0 in a Nutshell by Joseph Albahari and 
Ben Albahari, and it’s a thorough guide to everything 
that G# has to offer. You’ll learn about advanced G# 
language features, you’ll see all of the essential .NET 
Framework classes and tools, and you’ll learn more 
about what’s really going on under the hood of G#. 

Check it out at: http:/ / www.oreilly.com/. 
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Index ♦ 


Symbols 

& (ampersand) 

& (logical AND) operator 852 
&& operator 76, 99, 851 

<! — and —>, surrounding comments in XML 543 
* (asterisk) 

*= (multiplication and assignment) operator 68, 117, 
151, 154 

multiplication operator, converting types 147 
@ (at sign), preceding filenames 413, 425 
〜 (bitwise complement) operator 852 
: (colon) 

implementing an interface 298 
using to inherit from base class 256 

?: (conditional) operator 766, 851, 863 

{ } (curly brackets) 129 

code for classes or methods in 75 

grouping sttements into code blocks 61, 62 

leaving out for code blocks 241 

matching up using the IDE 71 

using to pass variables to string in Stream Writer 414 

.(dot) operator 68 

\\ (double backslash), escaping backslash in strings 425 
=(equals sign) 

assignment operator 67, 72, 851 
combining with logical operators 853 
==(equality) operator 76, 862—864 
=versus == operator 72, 81 

! (exclamation mark) 

!= (inequality) operator 76, 180 
NOT operator 68, 149, 284 

> (greater than) operator 76 
<< (left shift) operator 853 
< (less than) operator 76 
- (minus sign) 

--(decrement) operator 68 

-=(subtraction and assignment) operator 151, 154 


subtraction operator 68, 147 
\n (line feed character) 75, 106, 143, 397, 413, 425 
?? (null coalescing) operator 851 
=> operator 

in lambda expressions 871 
(pipe symbol) 
logical OR operator 852 
|| (OR) operator 76, 434, 851 

+ (plus sign) 

+= (addition and assignment) operator 38, 68, 709 
addition operator 68 

addition or string concatentation, conversion of types 
with 147-148 

++ (increment) operator 68, 851 
string concatenation operator 68, 853 

>> (right shift) operator 853 
\r (return character) 397, 425 
;(semicolon), ending statements 59, 75 
/ (slash) 

/* and */ enclosing multiline comments 851 

comments beginning with // 75 

comments beginning with III 92, 97 

comments surrounded with /* and */ or // 69 

division operator 68 

division operator, converting types 147 

III (triple-slash), denoting XML comments 848 

I (square brackets) 
using to access elements 168 

using to retrieve object from list, array, or dictionary 

866 

usng to declare and initialize arrays 166 
\t (tab character) 143, 413, 425 
A (XOR) operator 852, 863 

A 

About popup control, using Settings charm to open 822 

abstract classes 320—327 
Fireside Ghat 326-327 
usefulness 321—322 
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About popup control, using Settings charm to open 822 

abstract classes 320—327 
Fireside Chat 326-327 
usefulness 321—322 

abstraction 

as principle of OOP 330 
general versus specific 249-255 

abstract keyword 323 

abstract methods 320,323 

access modifiers 315-317, 856 
internal 315 
private 315 
protected 315 

protected versus private or public 318 
public 315 
scope 316 
sealed 315 

addition and assignment operator (+=). See + (plus sign), 
under Symbols; compound operators 

addition operator. See + (plus sign), under Symbols 

Adventure Game program (see labs, #2 The Quest) 

Albahari, Ben 875 

Albahari, Joe 690, 860, 868, 875 

aliens ， 8—9, 45—52, 53—56, xi—xiv 
gastronomy 8 
saving Earth from 807—830 

allocate, defined 429 
allocated resources 429 
ambiguity, avoiding 328 

AND operator. See & (ampersand), under Symbols 
Angle Converter class 781 
animal inheritance program 250—256 
animations 

bouncing Label controls 180 

building program that animates bees and stars 796- 
805 

building with G# 788 

making bees fly around a page 790 
code creating enemy bouncing animation (example) 
34 

desktop apps 98-100 

generating method stub for Animate Enemy () method 
(example) 33 


key frame 7 80 

using Double Animation to animate double values 779 
visual state changes for buttons 778 
Windows Phone app, Bee Attack 839 

anonymous, defined 663 
anonymous methods 870 

anonymous types 680, 870 

creating using new keyword 662, 663 
APIs, defined 57 

AppBarButtonStyle 774 
DoubleAnimation 779 
AppBar controls 542 
AppendAllText() method 424 

Append(), AppendFormat() and AppendLine(), String- 
Builder 853 

Appliance project 308-312 
Appliance class 308 
downcasting 310 

interfaces 311 
upcasting 309 

interfaces 311 

ApplicationData.Gurrent.LocalFolder 549 
application life cycle, Windows Store apps 522 
Application object 659 

application programming interfaces. See APIs 

Application.Resources tag 784 

AppName, changing for Windows Store app 23 

apps. See also Windows Store apps 
building from ground up 73 
App.xaml.es file 4, 659, 720—723 
App.xaml file 659, 688, 692, 784 
ArgumentException 577, 601 
arguments 148 

compatibility with types of parameters 149 
arithmetic operators 68 

automatic casting with 147, 148 
arrays 166—167, 304 

containing reference variables 167 
difficulty in working with 358 
finding length 167 
of objects 184 

using to create deck of cards 357 
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using [] to return object from 866 
versus Lists 360—362 

as keyword 307 

illegal downcasting 312 
use with objects 641 
using in downcasting 310, 331 
value types and 632 

assemblies 315, 854-857 

Assets folder 

adding image files to 664 

assignment 15, 77, 81 
= operator 851 
values to variables 67 

assignment operator (=) 72. See also = (equals sign), 
under Symbols 

asynchronous methods 538 

using Task to call one from another 557 
using to find and open files 548 

async modifier 538 

in OpenFile() and SaveFile() methods 545 
with await operator in method’s delcaration 544 

attributes 445 

automatic properties 304 

AutomationProperties class 776 

await operator 538, 557, 580, 721 

inability to use in body of catch clause 585 
in OpenFile() and SaveFile() methods 545 
with async keyword in method declaration 544 

B 

BackgroundWorker, using to make WinForms responsive 
858-860 

backing fields 223, 228, 336 

Baseball Simulator project 702—719 
callbacks 736-738 
Fan class 712-715 
Pitcher class 712-715 
subscription and public events 735 

base classes 248 

building Animal base class for zoo simulator 251-252 
colon (:) 256 
constructors 273 


extending 255 

subclasses accessing with base keyword 272 

upcasting 309 

using subclasses instead 261 

base keyword 272,317 

Basic Page template 502 

Beehive Management System project 279-289, 294—307 
building form 283 

building Worker and Queen classes 283 
class hierarchy with Worker and Queen classes 295 
extending through inheritance 287—291 
interfaces 296-305 
inheritance 305 
references 302-303 

making Worker class inherit from Bee class 288 
OutOfHoneyException 598 
updating form to instantiate bees 2B8 

bees 279, 596-598, 602 

accounting systems 279-285, 287-291 

animating 788—791 

animating bees and stars 796-805 

binary and decimal, converting between 143 

binary files 448 
comparing 453 
hex dump 455 
working with 455 
writing 451 

BinaryFormatter 444 

DeserializeO method 444, 447 
Serializable attribute 445, 447 
SerializationException 584 
Serialize() method 444 

Binary Reader 452 

binary serialization versus data contract serialization 546 

BinaryWriter 451 

binding. See data binding 

Binding object 512, 513 

binding path 512 
property type 525 

Birthday Party project 238—246 
adding controls to form 243 
adding fee for parties over 12 people 247 
BirthdayParty.GalculateGost() 247 


you are here ► 


879 



the index 


Birthday Party class 239-242 
inheriting from Party class 274—278 
testing the program 246 
writing code to make controls work 244 

bitwise complement operator (〜） 852 

Blank App template 4, 12, 58, 507 
StandardStyles.xaml file 543 

Blend for Visual Studio 2012 796 

blocks (of code) 31, 62, 81 

leaving out curly brackets 241 

Boolean values, converters for 773 

bool type 67, 142, 144 
true or false values 68 

Border controls 514 

BottomAppBar property 542 

boxed objects and structs 632, 640 
boxed struct 641 

break keyword in case statements 437, 438 

breakpoints 

inserting into code 69 
knowing where to put 582 

break statements 850 

Build menu (IDE) 56 

Bullet Points 
delegates 739 
event handlers 739 
exception handling 601 
Lists 364 

reference variables 172 
try/catch blocks 601 
types 172 

Button controls 

adding code to interact with objects 131 

adding to form 130, 135 

adding to page 54 

adding to Windows Desktop app 89 

Button class 110 

changing properties for Windows Desktop app 97 

changing Text property in Properties window 90 

Content property 73,776 

making them do something 75 

MenuMaker project 517 

naming using x:Name property 73 


visual states 778 

XAML, altering appearance with style 775 
buttons. See Button controls 
by keyword 679 

byte arrays 425 

moving text around in 450 
byte order mark 460 

byte type 142, 144 

casting int variable too large for 147 

c 

G# 

and .NET Framework, capabilities of 875 
application code 11 
benefits of 2 
case in 231 

combining with XAML 7 

files created by Visual Studio when creating new 
project 4 

Microsoft reference for 853 

using with Visual Studio IDE, capabilities of 3 

C# 5.0 in a Nutshell 875 

Calculator program 604-605 
temporary solution 605 
callbacks 736—740 
versus events 740 
camelGase 231 

Gandy Control System 120—126 

Canvas control 

adding Ellipse control 26 
adding to Windows Store app 21 
animating Canvas.Left property 791 
binding controls to, using ItemsPanelTemplate 
793-795 

child controls, data binding and 792 
dragging, changes to Left and Top properties 26 
turning into gameplay area 24 

capitalization 231 

Captain Amazing 612—616, 625, 626, 641, 647 
case in G# 231 

case sensitivity in C# and XAML 19 

case statements 437, 438. See also switch statements 
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casting 146—148 

arithmetic operators, automatic conversions with 147 

automatic casting in G# 148 

decimal value to int type 146 

too-large value, automatic adjustment in G# 147 

wrapping numbers 147 

catch blocks 585, 587, 601 

following in debugger 588—589 
letting your program keep running 604 
multiple, to handle multiple types of exceptions 596 
with no specified exceptions 592 

chaining events 709,718 

Character Map (Gharmap.exe) 448, 449, 776 

Charms 742—743 

char type 143, 144, 449 

GheckBox controls 83 

adding to Windows Desktop app 89 
Birthday Party project 243 

changing Text and Checked properties in Properties 
window 90 

GheckFileExists property, OpenFileDialog 421 
CheckPathExists property, OpenFileDialog 421 
child 250 

Children collection, XAML controls 515 

class diagrams 107 

DinnerParty class (example) 202 
moving up, not down 265 
organizing classes to make sense 124-126 
private fields and types 282 
using to plan classes 122 

classes 60-62, 65, 92—94 ， 102—107 
abstract (see abstract classes) 
adding new class to desktop app 94 
code between { } (curly braces) 75 
collection 359 
concrete 320 
copying 107 
creating (example) 129 
creating instances of 117—119 
creating using code snippets 84 
designing 103, 124—126, 128, 134, 239 

separation of concerns 278 
encapsulation 212—217, 220—221 
finding out if class implements specific interface 304 


inheritance. See inheritance 

internal 315 

looking for common 253 

members 315 

methods 61 

namespaces 65 

naming 120—121 

natural structure 122 

never instantiated 319 

organizing 124 

partial 81 

private 315 

protected 315 

public 315 

required by interface to implement certain methods 
and properties 296 
sealed 315, 643 
serializable 445 
similarities between 134 
statements in 81 
static 115 
subscribing 707 

using lines for adding methods from other namespaces 
91 

using to build objects 109 
versus structs 640 

why some should never be instantiated 322 
class hierarchy 249, 254 
Hive Simulator 295 
class libraries, creating 854 
clauses in LINQqueries 654 
Clone class, implementing IDisposable 620, 621 
Close buttons, Windows Store apps and 522 

clowns 117-119, 313 

Fingers the Clown 313, 734, 756 
scary clown 313 

GLR (Common Language Runtime) 57, 171 
code 

advice for code exercises 112 
automatically generated by IDE 7, 81 
avoiding duplication 251 
copying 107 
repeating 247 
similar 248 

code blocks 31, 62, 81 
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leaving out curly brackets 241 
code snippets 

rearranging to make working G# program 82 
using to create classes 84, 127, 138 
using to write for loops 71 

collection initializers 168, 368—369 

collections 358-408. See also listings of individual collec 
tion types 

binding to, with ObservableGollection 513 
controls contained in another control 515 
dictionaries 387-400 

exception from trying to access nonexistent element 
577 

generic 367 

implementing IEnumerator<T> GetEnumerator() 
653 

indexers 866 
lists 359—376 

performing calculations on 666 
queues and stacks 401—406 

using join to combine two collections into one query 
677, 678 

versus tables 657 
Gollection<T> interface 865 
colon operator 298 
Color.FromArgb() method 98 
color gradient, adding to XAML control 24 
colors 

cycling through form’s background colors in anima¬ 
tion 98 

predefined, or making your own 98 
selecting color theme in Visual Studio 5 

GomboBoxItem object 524 

command-line arguments 458 

CommandsRequested event 743 

comments 

adding to code, starting with // 75 

/* and */ enclosing multiline comments 851 

beginning with III 92, 97 

starting with /* or // 69 

XML 543, 848 

Common Intermediate Language (IL) 857 
Common Language Runtime (GLR) 57, 171 
Common States group 778 


CompareTo() method 371 

compiler errors, classes implementing interfaces 296 
compiling programs, using Build menu in IDE 56 
compound operators 68, 151, 154 

concatenation operator (+) 68 

automatic type conversions with 148 
concrete classes 320 

conditional expressions. See also conditional tests 
consolidating 869 

conditional operator (?:) 766, 851, 863 
conditional operators 76 

conditional tests 76-80, 81 
resulting in infinite loops 79 
console applications 266 
Console.Error.WriteLine() 458 
Console.WriteLineO method 224 
constants 202 

constructors 227, 229 

base class and subclass 273 
building new with switch statement 439 
closer examination of 228 
exceptions in 589 
parameterless 523, 528, 789 
without parameters 228 

container tags 7 
G ontentG ontrol 

adding to Windows Store app 21 
creating new G ontentG ontrol object and adding 
method 32 

Edit Template, Create Empty... 25 
grouping, using StackPanel 23 

content controls 514 

Content property 

Button controls 22 
user controls 759 
XAML controls 514, 515 

continue statements 850 
GontrolGollection object 494 
controls 10 

adding code to make controls interact with player 42 
adding code to make them interact with player 42-44 
adding to page 54 
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altering appearance of a type, using styles 774—777 
altering appearance of every control of a specific type 
111 

binding to canvas using ItemsPanelTemplate 793-795 
G# code for 11 

creating UI controls with G# code 786 
data binding, connecting XAML pages to classes 512 
displaying collections, data binding to collection 513 
double properties, animation for 779 
dragged from Toolbox onto page, XAML generated 
for 21 

dragging around Canvas 26 

initialization on forms with InitializeGomponent() 

228 

in MWM applications 769 
in .NET for Windows Store apps 57 
making game work in Windows Store app 24 
nesting inside other controls 515 
page layout starting with 502 
program animating Label controls 180 
using properties to change look of 22 
visual states causing response to changes 778 
Windows Store app, on a page 500 
WinForms apps 494—497 
XAML, containing text and more 514 

Controls property 

controls containing other controls 494 
Form class and 497 

GontrolTemplate 25, 47, 775-776. See also templates 

Gonvert() and GonvertBack() methods, value converter 
770 

converters 770—773 

automatically converting values for binding 770 
converting minutes and seconds to angles 781 
Convert.ToString() and Gonvert.ToInt32() 852 
working with many different types 772 

covariance 380 

GreateDirectory() method 424 
GreateFileAsync() method 549 
Greate() method 424 
GryptoStream 418 
.csproj (project) files 56 
curly brackets. See { }, under Symbols 
GurrentQueryResults property 662 


D 

data 

pulling data from multiple sources 652 
storing categories of 352 

data binding 

Canvas child controls and 792 
connecting XAML pages to classes 512 
converters automatically convering values for 770 
designing for 748 

designing for binding and data handling with MWM 
pattern 749 

INotifyPropertyGhanged, bound objects sending 
updates 526 

public properties for Go Fish game conversion 528 
RosterGontrol XAML control (example) 754 
to collections, with ObservableGollection 513 
two way binding, getting or setting source property 
513 

using data template to display objects 524 
using ItemsPanelTemplate to bind controls to a canvas 
793-795 

using to build Sloppy Joe’s menu 516—521 
data context 512, 756, 765, 793 
RosterGontrol (example) 754 
setting for menu maker (example) 517 
setting for StackPanel and its children 523 

DataGontract attribute 547, 551 

data contract serialization 546 
data contract, defined 547 
disambiguation in 556 

sending some objects to app’s local folder 552-556 
using XML files 547 

whole object graph serialized to XML 551 
DataMember attribute 547, 551 
DataModel folder, adding data classes to 694 
data template, using to display objects 524 
Deadly Diamond of Death 328 

debugger 575, 579-581 
Bullet Points 601 
catch blocks 

following flow 588—589 
multiple 596 

with no specified exceptions 592 
exploring delegates 733 
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finally block 590 

following try/catch flow 588 

knowing where to put breakpoints 582 

Step Into command 580 

uses for 587 

using to see changes in variables 69 
Watch window 587 

running methods in 582 
(see also exception handling) 

debugging 579 

Excuse Management program 580—581 
System.Diagnostics.Debug.WriteLine() 496 
Windows Desktop app in IDE 91 

Debug menu 
Continue 70 
Start Debugging 56, 70 
Step Over 70 
Stop Debugging 99 

decimal and binary numbers, converting between 143 
decimal type 143, 144 

attempting to assign decimal value to int variable 146 
using for monetry values 205 

decrement operator (- -) 68 

default property of controls 515 

deferred evaluation 667 

delegate, defined 730 

delegates 739 

callbacks and 738 

defined 731 

delegate type 731 

events, callbacks, and 740 

exploring in debugger 733 

hooking up to one event 736—738 

in action 732—733 

multiple events 718 

using the Windows settings charm 742 

Windows Phone app, Bee Attack 841 

Delete() method 424 
DependencyProperty class 513 
deployment package 11 
deselecting controls for editing 23 
design 

intuitive classes 134 


making code intuitive with class and method names 
120-121 

separation of concerns 278 
design patterns 740. See also MWM pattern 
Callback pattern 740 
Factory Method pattern 794 
Model-View-Controller (MVG) pattern 759 
Model-View-ViewModel (MVVM) pattern 748—749, 
758-760, 769 
Observer pattern 740 

desktop applications 57 
destructor 618 
developer license 51 
device-independent units 507 

dialog boxes 422-424 
as objects 423 
customized 425 
file dialogs 427 
popping up 421 

DialogResult 421—423 

excuse management program 434 
dictionaries 387-389 

adding to app’s resources 784 
Add() method 387 
building program that uses 389 
GontainsKey() method 387 
functionality rundown 388 
keys 387 

keys and values 388 

using [] to return object from 866 

Dinner Party Planning project 198—209 

GalculateGostOfDecorations() method 210 
cost estimate 199 
DinnerParty class 201, 204-205 
encapsulating fields in DinnerParty class 211 
fixing calculator 232—234 
inheriting from Party class 274—278 
numericUpDown control 209 
options, caluelating individually 208 
recalculating new individual costs 209 
similarities between DinnerParty and BirthdayParty 
classes 248 
test drive 206 

directories 
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creating new 424 
deleting 424 
getting list of files 424 

Directory.GetFiles() method 435 
Disabled state (controls) 778 
disambiguation 556 

Dispose() method 429, 430, 602 

calling outside of using statement 603 
finalizers 622, 624 
making object serialize in 623 
using statement 620-622 

DivideByZeroException 573, 578 
division operator (/) 68 
DLL file extension 854 

Document Outline window, modifying controls 25 

documents library, accessing with Windows Store apps 
550, 556 

dot (.) operator 68 

Double Animation 779 

animating Canvas.Left property 791 
double type 143, 144 
defined 142 
downcasting 310 
failure of 312 
interfaces 311 
using as keyword 331 

E 

editors 

building less simple text editor 542-545 
evolution of code editors 62 

Edit Style right-mouse menu 73 

changing text style for TextBlock 23 
Edit Text right-mouse menu 

changing text for TextBlock control 23 
editing text for button in Windows Store app 22 

Ellipse controls 

adding to Canvas 26 

editing to make enemies look like aliens (example) 46 
ellipses 25 
emulators 

running Windows Phone apps in 833 


Windows Phone app, requiring Hyper-V 833 
encapsulation , 197—236, 461, xv—xxx 
as principle of OOP 330 
automatic properties 225 
benefits for classes 217 
better, using protected modifier 318 
Birth day Party class (example) 245 
defined 211 
example 222 
ideas for 221 

Navigator program (example) 218 
using to control access to class methods, fields, or 
properties 212—217 

well encapsulated versus poorly encapsulated classes 

220 

encodings 412, 425 
Unicode 448, 449 
end tags 7 

entry point for a program 92, 265 
changing 94 

enumerable objects, creating with yield return 865—867 
enumeration 352-353 

enums 353-357 
big numbers 354 

building class that holds playing card 355, 356 
representing numbers with names 354 
versus Lists 367 

equality 

== operator, IEquatable, and Equals() 862-864 
equality operator (==) 72, 76 
Equals() method 862-864 
error handling 592 

Error List window 5 

examining errors in 34 
troubleshooting compiler errors 59, 62 

errors 

avoiding file system errors with using statements 430 
compiler errors and interfaces 296 
DivideByZero 573 
invalid arguments 149 

escape sequences 75 

EventHandler 706, 709 
as type of delegate 739 
event handlers 214,703 
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adding 709 

adding for button in Windows Desktop app 90 

adding to controls to interact with player 42-44 

automatic 710—711 

Bullet Points 739 

excuse management program 432 

for Birthday Party project controls 244 

for key presses, swipes, and taps in Invaders lab 824 

hooking up 718 

how they work 704—705 

keyboard, for Invaders game 820 

page root, for swipes and taps 820 

private or public keyword with 214 

returning something other than void 709 

stopwatch app user control 768 

TextGhanged event handler for TextBox 542 

types of 709 

event keyword 706 

events 703-744 

callbacks versus 740 

connecting senders with receivers 730 

creating app to explore routed events 725-729 

defined 703 

delegates 718, 739 

forms 717 

how they work 704—705 
Model communicating in MWM apps 759 
naming methods when raising events 708 
notifying bound controls of changes in Ovservable- 
Gollection 526 
objects subscribing to 735 
raising 527, 708 

raising events with no handlers 708 
reference variables 730 
routed events, use by XAML controls 724 
stopwatch app Model, alerting rest of app to state 
changes 764 
subscription to 

how it works 704-705 
possible probelms with 735 
subscribing classes 707 

use by Windows Store apps for process lifetime man¬ 
agement 720—723 

ViewModel, passing to View in MWM apps 769 
(see also event handlers) 

exception, defined 574 


exception handling , xxiii—xxx 
Bullet Points 601 
catch block 585, 587 

catching specific exception types 592, 603 
DivideByZeroException 573, 578 
dividing any number by zero 573 
Exception object generated when program throws 
exception 574 

exceptions in constructors 589 

finalizers 625 

finally block 590 

FormatException 578 

handled versus unhandled exceptions 592 

handling, not burying 604 

handling versus fixing 605 

IDisposable interface, implementing to do cleanup 
602 

IndexOutOfRangeException 578 

invisible to users 609 

NullReferenceException 573 

OverFlowException 578 

program stopping with exceptions 592 

simple ideas for 606 

spotting exceptions 575 

throwing and catching exceptions 597 

try block 585, 587 

unexpected input 586 

unhandled exceptions 582 

using exceptions to find bugs 577 

using statement 601 

why there are so many exceptions 575 

(see also debugger) 

Exception objects 574, 575, 601 

inheriting from Exception class 578 
Message property 596 

using to get information about the problem 595 

Excuse Manager project 431-435 
building the form 432 

changing to use binary files with serialized Excuse 
objects 461 
code problems 583 
debugging 580-581 
DialogResult 434 
event handlers 432 
Folder button 432 
Random Excuse button 435 
rebuilding as Windows Store app 558-568 
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solution 434-435 

turning into Windows Store app 488 
unexpected user behavior 576—577 

executables 56 

executables 854 

Exists() method 424 

extend 250 

Extensible Application Markup Language. See XAML 

extension methods 642, 643 
LINQ 653 
strings 644 

F 

Factory Method pattern 794 

Farmer class (example) 222—228 

constructor, using to initialize private fields 227 
fully encapsulating 225 
testing 224-225 

fields 33, 116 

adding to form 130,132 
backing fields, set by properties 223 
initializing public fields 226 
interfaces 297 
masking 228, 235 

objects using each other’s fields, problems from 208 

private 211-216, 227, 231 

public 221 

versus methods 116 

versus properties 318 

with no access 214 

FIFO (First In, First Out), queues 402 

File class 424 

Glose() method 460 
Greate() method 453 
OpenWrite() method 453 
ReadAllBytes() method 449, 450, 460 
ReadAllLines() method 460 
ReadAllText() method 427, 460 
static methods 460 
versus Filelnfo class 460 
WriteAllBytes() method 449, 450, 460 
WriteAllLines() method 460 
WriteAllText() method 427, 449, 460 

file dialogs 427 


causing WinForms apps to become unresponsive 540 
Filelnfo class 424 

versus File class 460 
file I/O 

FilelO class 540 
Windows Store apps 537 

filenames, @ in front of 413 
FileNotFoundException 603 
FileOpenPicker object 540 
files 

appending text to 424 
finding out if exists 424 
getting information about 424 
reading from or writing to 424 
(see also streams) 

unsaved files denoted by * (asterisk) in IDE 58 
writing 436 

FileSavePicker object 541 

File Streams 411 

Binary Reader 452 
BinaryWriter 451 

created and managed by StreamWriter 413, 425 

reading and writing bytes to file 412 

versus StreamReader and StreamWriter 460 

Filter property 

OpenFileDialog object 422, 427 
SaveFileDialog object 423 

finalizers 618 

depending on references being valid 622 
Dispose。method 622, 624 
exceptions thrown in 625 
fields and methods 625 
garbage collection 619-621 

finally block 590, 592 

getting with using statements 601 
try/finally 603 

float type 143， 144 

adding int type to, conversion with + operatotr 147 
FlowLayoutPanel 427 
Controls property 494 
focused state, animating 779 

folders. See also directories; files 

high-profile, accessing with KnownFolders 550 
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foreach loops 

accessing all members in stack of queue 404 
from clause in LINQqueries compared to 670 
lists 363, 364 

using IEnumerable<T> 379 
for loops 71, 77-81, 100 
Forml form, programs without 265 
FormatException 578 
Form object 494, 497 
forms 

adding buttons 130, 135 
adding method 131 
adding variables 130 
as objects 170—171 
events 717 

Frame object 659 
Frame property, XAML Pages 659 
from clause 656, 670, 673 
fully qualified names 60 
functions 330 

G 

Game Over text, adding to Windows Store game 26 

garbage collection 158, 171, 625 

code that automatically triggers, caution with 618 
finalizers 619—621 

GG.Gollect() method 619, 625 

GDI+ graphics 489 

generic collections 364, 367, 401—404 

generic data types 367 

get accessor 223, 229 

interface properties 304 

interfaces with get accessor without set accssor 301 
GetFiles() method 424 
GetLastAccessTime() method 424 
GetLastWriteTime() method 424 
GetType() method, Type class 861 
Go Fish! card game 390—400 
Go To Definition 429 


finding information about class not in your project 
548 

goto statements 851 
GPS navigation system 103 
gradients, adding to XAML control 24 
graphical user interface (see GUI) 
greater than operator (>) 76 

grids for Windows Store app page 506 
adding controls to 20 
setting up 18 
StackPanel versus 515 

GridView controls 793 

implementing semantic zoom 685 
GroupBox control 239 
group by clause 674, 679 
group clause 679 
group keyword 673, 674 

GUI (Graphical User Interface) 111 
labs, #1 A Day at the Races 194 
guys (Two Guys project) 128—133, 135—136 
GZipStream object 411 

H 

Handled property, RoutedEventArgs object 724 
Head First Labs website, downloading solutions from 112 

heap 118, 119 

versus stack 631—633 
Hebrew letters 449 

heights and widths, Windows Store app page 504 

“Hello World” program, building from command line 
857 

hexadecimal 448, 455 
working with 456 
hex dump 455 

StreamReader and StreamWriter 457 
using file streams to build hex dumper 456 

Hide and Seek game 339—346 

hiding methods 271 

overriding versus 268 
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using different reference to call hidden methods 269 
using new keyword 269 

hierarchy 249 

creating class hierarchy 254 
defined 255 

HorizontalAlignment property, controls 22 

house model exercise 332—339 
playing hide-and-seek 339-346 
hovering over a variable during debugging 70 
Hyper-V 833 



IGlown interface 300 

access modifiers 316—317 
extending 313—314 

IGollection<T> interface 666 
IGomparable interface 371 

IGomparer interface 372 
complex comparisons 374 
creating instance 373 
multiple classes 373 
SortBy field 374 

IDE (Integrated Development Environment) 2. See 
also Visual Studio IDE 

creating solutions (.sin files) 56 
editing program files 56 

making changes in, and IDE changes to default files 
55 

Visual Studio for Windows Phone IDE 834 
what it does in application development 54 

IDisposable interface 429, 603, 620 
avoiding exceptions 602 
Dispose() as alternative to finalizers 622 
streams implementing 430 

IEnumerable interface 652, 653, 865 
foreach loops using 379 
IGollection<T> interface and 666 
upcasting entire list with 380 

IEnumerator interface 866 
IEnumerator<T> interface 866 
IEquatable<T> interface 862-864 
if/else statements 72, 436 


checking GakeWriting.Length (example) 241 
practice with 83, 85 

seting up conditions and checking if they’re true 
76-80 

if statements 149, 436 

consolidating conditional expressions 869 
in GandyGontroller class method (example) 122 

IL (Intermediate Language) 857 
increment operator (++) 68, 851 
index (arrays) 166 — 167 
indexers 866 

IndexOutOfRangeException 574, 578 
inequality operator (!=) 76,180 
infinite loops 79 

inheritance 247—292 

as principle of OOP 330 

base class method subclass needs to modify 259 
building class model from general to more specific 
249 

classes you can’t inherit from 643 
class hierarchy, Hive Simulator 295 
class that contains entry point 265 
constructors for base class and subclass 273 
creating class hierarchy 254 
designing zoo simulator 250 
each subclass extending its base class 255 
interface 305 

interface, class implementing 306 

looking for classes with much in common 253 

multiple 328 

Party base class for DinnerParty and BirthdayParty 
classes 274-278 
passing instance of subclass 265 
subclass accessing base class using base keyword 272 
subclasses 259-260 
terminology 250 

using colon to inherit from a base class 256 
using override and virtual keywords to inherit behav¬ 
ior 270 

using subclass in place of base class 261 
using to avoid duplicate code in subclasses 251 
using to extend bee management system (example) 
287-291 

(see also interfaces) 
inherit, defined 249 
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InitialDirectory propery, OpenFileDialog 422, 427 
initialization 133 

Initializedomponent() method 228 
INotifyPropertyGhanged interface 526, 757 

instances 110 

creating 117-119, 129 
defined 110 
fields 116 

keeping track of things 116 

requirement for, non-static versus static methods 115 
instantiation, interfaces 302 
integers, using in code 155 

Integrated Development Environment (IDE). See IDE; 
Visual Studio IDE 

IntelliSense (in Visual Studio) 59 

interface keyword 297 

interfaces 296-318 

abstract classes and 320-322, 326 
abstract methods in 323 

allowing use of class in more than one situation 298 

avoiding ambiguity with 328 

colon operator 298 

compiler errors 296 

containing statements 312 

defining using interface keyword 297 

downcasting 311 

easy way to implement 312 

extending 643 

fields 297 

finding out if class implements specific interface 304 

generic, for working with collections 364 

get accessor without a set accssor 301 

IHidingPlace (example) 340 

implementing 299—301 

inheriting from other interfaces 305 

is keyword 304, 307 

naming 297 

new keyword 302 

object references versus interface references 318 
public 297 

public void method 301 
references 302-303 
why use 318 

requiring class to implement methods and properties 
296 


similarity to contracts 312 
upcasting 309, 311 
void method 300 
why use 312,318 

Intermediate Language (IL) 857 

internal access modifier 315, 824, 856 

Internet Explorer (IE), About option 742 

int type 67, 142 ， 144, 145 

adding to float type, conversion with + operatotr 147 
assigning value 155 

attempting to assign decimal value to int variable 146 
casting int variable (too big) to byte 147 
declaring 155 

no automatic conversion to string 149 
invalid arguments error 149 
IRandomAccessStream 549 
IsHitTestVisible property 45, 724, 728-729 

is keyword 304,310 

as keyword versus 307 

checking class or interface sublcassed or implemented 
306 

IStorageFolder interface 548 

methods to work with its files 548 
IStorageltem interface 549 
IsVisible property 772 
items in a list 524 

ItemsPanelTemplate, using to bind controls to a canvas 
793-795 

ItemsSource property 792 

binding items to ListView ， GridView, or ListBox con¬ 
trols 793 

I Value Converter interface 770 



join clause 677, 678, 679, 680 
jump statements 850 

K 

Kathleen’s Birthday Party Planner. See Birthday Party 
project 

Kathleen’s Party Planning program. See Dinner Party 
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Planning project 

keyboard event handlers 820, 824 
key frame animations 780 
key frames, defined 7 80 

keywords 150, 182 

reference for G# keywords 853 
KnownFolders class 550 



Label controls 

adding to Windows Desktop app 89 
animating 180—181 
Birtyday Party project 243 
button updating 75 

changing properties in Properties window 90 
labels for objects (see reference variables) 
labels, loop using goto statement and 851 
labelToGhange properties 499 
labs 

# 1 A Day at the Races 187—196 
application architecture 192 
Bet class 191 
Bet object 193 
Betting Parlor groupbox 195 
dogs array 192 
finished executable 196 
Greyhound class 190 
GUI 194 
Guy class 191 
Guy object 193 
guys array 192 

PictureBox control 190, 192, 194 
RadioButton controls 192 

this keyword 191 
#2 The Quest 465—486 

Bat subclass 479 

BluePotion class 482 

Enemy class 478 

Enemy subclasses 479 

form, bringing it all together 483—485 

form, building 468—469 

form delegating activity to Game object 471 

form, UpdateCharacters() method 484 


Game class 472—473 

Ghost subclass 479 

Ghoul subclass 479 

ideas for improving the game 486 

IPotion interface 482 

Mace subclass 481 

Mover class 474—475 

Mover class source code 475 

objects, Player, Enemy, Weapon, and Game 470 

Player class 476 

Player class Attack() method 477 
Player class Move() method 477 
RedPotion class 482 
Sword subclass 481 
Weapon class 480 

Weapon subclasses 481 
#3 Invaders 807—830 

additions 829 

architecture 810 

building ViewModel 823 

control for big stars 821 

Game class 814 

Game class, filling out 816 

handling user input 824 

InvadersHelper class for ViewModel 821 

InvadersModel class 814 

InvadersModel class, filling out 816 

InvadersModel class methods 815 

Invaders page, building for the View 818 

Invaders ViewModel class methods 825 

LINQ 817 

maintaining play area’s aspect ratio 819 

movements 809 

object model for the Model 812 

player’s ship, moving and dying 827 

responding to swipe and keyboard input 820 

shots fired 828 

types of invaders 809 

using Settings charm to open About popup 822 
View, updating when timer ticks 826 
lambda expressions 870, 871 

Launched event handler, updating 723 
Length property, arrays 167 
less than operator (<) 76 
libraries 
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creating class libraries 854 
LIFO (Last In, First Out), stacks 403 

line breaks. See also \n; \r 

adding to XAML text controls 514 
LINQ (Language Integrated Query) 649—700 
combining results into groups 673, 674 
complex queries with 655 
deferred evaluation of queries 667 
difference from most of G# syntax 667 
extension methods 653 
from clause 670, 673 
Invaders lab 817 
join queries 680 
LINQto XML 872 
modifying items 666 
.NET collections 653 
orderby clause 670,673 
performing calculations on collections 666 
pulling data from multiple sources 652 
queries 654 

queries, anatomy of 656 
query statements 670 
select clause 670 
Take statement 670 

using join to combine two collections into one query 
677, 678 

var keyword and 680 
versus SQL 657 
where clause 670 

LINQPad 690 

ListBox controls 793 

Windows Store Go Fish! app page 502 
ListBoxItem object 524 
lists 

using [] to return object from 866 
List<T> class 359-376 

building class to store deck of cards and form using it 
382-386 

CompareTo() method 371 

converting from stacks or queues 404 

creating, using collection initializer 368 

dynamically shrinking and growing 363 

foreach loop 363, 378 

foreach loop using IEnumerable<T> 379 


IGomparable interface 371 
IGomparer interface 372 

IGomparer interface, complex comparisons with 374 

IGomparer interface, creating an instance 373 

IGomparer interface, multiple implementations 373 

sorting 370 

Sort() method 370 

storing any type 364 

things you can do with 360 

upcasting, using IEnumerable<T> 380 

versus arrays 360—362 

versus enums 367 

ListView controls 793 

app managingjimmy’s comic collection 664 
data binding to properties in MenuMaker (example) 
517 

implementing semantic zoom 685 
populating using one-way data binding 516 

ListViewItem object 524 

literals 143, 172 

logical operators 851 

&, I, and A 852 
combining with = 853 
using to check conditions 76 

long type 142， 144 

converting to a string 148 
loops 71 

adding while and for loops to program 77—79 
infinite loops 79 

continue and break keywords 850 
foreach. See foreach loops 

using for Windows desktop app animation 98-100 
lowercasing 231 

M 

Main() method 92, 93 
MainPage class 499 

ManipulationDelta event 841 
event handler for 843 
Margin property 

Button controls 22 
Grid control 506 
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masking fields 228,231 
math operators 68 
members (class) 315 
memory 118 

stack versus heap 631—633 
MemoryStreams 411 

MessageBox.Show() method 95, 146 

argument type not matching parameter type 148 
conversion of \n character to line breaks 397 

MessageDialog object 538 

Message property, Exception object 578, 596 

methods 60, 105 
abstract 320, 323 

accessing private fields with public methods 214 

adding for form 131 

adding from other namespaces 91 

arguments matching types of parameters 149 

calling most specific 255 

calling on classes in same namespace 65 

code between { } (curly braces) 75 

creating using IDE 31—34 

defined 31,61 

delegates standing in for 731 

extension (see extension methods) 

extracting 868 

filling in code for 32 

get and set accessors versus 229 

hidden, using different references to call 269 

hiding versus overriding 268 

implementing interfaces 299—300 

in desktop app class 93 

interface requiring class to implement 296 

naming 120—121 

Navigator class (example) 104 

object 109 

optional parameters, using to set default values 636 

overloaded (see overloaded methods) 

overriding 252, 260 

passing arguments by reference 635 

private 213—214 

public 221 

public, capitalization in names 231 
returning more than one value with out parameters 
634 

return values 104 
signature 229 


static. See static methods 

this keyword with 170 

using override and virtual keywords 270 

versus fields 116 

with no return value 227 

Microsoft Download Center 49 

Microsoft reference for G# 853 

mileage and reimbursement calculator 151—154 

Model 749. See also MWM pattern 
rules for MVVM apps 769 

stopwatch app, events alerting app to state changes 
764 

using Model statement at top of ViewModel classes 
759 

Model-View-Controller (MVG) pattern 759 
Model-View-ViewModel pattern. See MWM pattern 
monetary values, decimal type for 205 
monitors, different, Windows Store apps on 507 
multiple inheritance 328 

multiplication operator. See * (asterisk), under Symbols 
MVG (Model-View-Controller) pattern 759 

MWM (Model-View-ViewModel) pattern 745—806 
animating bees and stars, program for 796-805 
debate between Model and ViewModel 760 
decisions about implementation 769 
decoupling of components 781 
designing for binding and data 749 
designing for binding or working with data 748 
dividing up concerns of the program 758 
enabling easier handling of code in future 759 
image animation and 792 
Invaders game 810 

Model communicating with rest of app 759 
rules for building apps 769 
state of the app 762 

stopwatch, analog, building with ViewModel 781—785 
stopwatch for BasketballRoster project 763—768 
user controls 753-757 

using to start building basketball roster app 750-752 

Windows Phone app, Bee Attack 836 

Windows Phone app, Bee Attack, ViewModel 840 

N 
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\n (line feed character) 75, 106, 143, 397, 413, 425 
Name box, Properties window 22 

namespaces 81 

and assemblies 854-857 
classes in 65 

generated by IDE for Windows Desktop app 92, 93 
in G# programs 60, 381 
reasons for using 556 

Windows Runtime and .NET Framework tools 57 
XML 522 

NavigatedFrom event handler 722 
navigating data, building apps for 692—700 
navigation, page-based, in Windows Store apps 658 

Navigation project 102—114 

better encapsulation for Route class 218 
Navigator class, methods to set and modify routes 104 

.NET Framework 875 

built-in classes and assemblies 315 
collections 359, 653 
events, raising, pattern for 527 
for Windows Store apps 489 
garbage collection 619 
generic collections 401 

generic interfaces for working with collections 364 
KnownFolders class 550, 556 
line breaks, adding with Environment.NewLine 397 
Math.Min() method 113 
namespaces 57, 60, 182 
.NET for Windows Desktop 57 
.NET for Windows Store apps 57 
ObservableGollection<T> class, for data binding 513 
overloaded methods, in built-in classes and objects 
381 

pre-built structures 2 
Random class 168-169 
sealed classes 642 

streams, readinga and writing data 410 
structs 627 

System namespace, use of 81 
System .Windows .Forms namespace 228 
using statement, to use animation code 34 
using tools in G# code 60 

NetworkStreams 411 

new keyword 108 
interfaces 302 


using to create anonymous types 662, 663 
using when hiding methods 269 

new statements 

creating array object 166 
creating class instances 118 
using contructor with 227 

Normal state (controls) 778 
NOT operator (!) 68 
nullable types 637 

helping to make programs more robust 638 
null coalescing operator (??) 851 
null keyword 171 
NullReferenceException 573 
numbers 

converting between decimal and binary 143 
data types for 142 

representing with names, using enums 354 
NumericUpDown controls 106, 151 
Birthday Party project 243 

0 

ObjectAnimationUsingKeyFrames animation 780 

object graphs 495-497 

using IDE to explore 497 

whole graph serialized to XML with data contract 
serialization 551 

object initializers 133, 135, 227 

initializing public fields and properties in 226 
object-oriented programming (OOP) 330, 461 
object references, versus interface references 318 

objects , xii—xxx 

accessing fields inside object 211 
accidentally misusing 210 
array of, iterating through 184 
assigning value 155 
as variables 155 
boxed 632 

building from classes 109 

Guy objects (example) 128 
controls as 180 
declaring 155 
downcasting 310 
encapsulation (see encapsulation) 
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event arguments 706 
finalizers (see finalizers) 
garbage collection 158 
knowing when to respond 702 
methods versus fields 116 
null keyword 171 

object animations to animate object values 780 
object tree 724 
object type 143 

assignments to variables, parameters, or fields with 
149 

reading entire with serialization 444 
references 303 

reference variables (see reference variables) 
states 442 

storage in heap memory 118 
subscribing to events 735 
talking to other objects 170, 172 
upcasting 309 

using each other’s fields, problem caused by 208 
using to program Navigator class (example) 108, 111, 
113 

value types versus 628 
versus structs 629, 641 

ObservableGollection<T> collections 513, 662, 726 
changes in, firing off event to tell bound controls 526 
changing properties and adding animations to controls 
795 

using for Menultems in MenuMaker project 517 
Observer pattern 740 
on ... equals clause 679 
OnSuspending() event handler 722 
OOP (object-oriented programming) 330, 461 
OpenFileAppBarButtonStyle static resource 543 
OpenFileDialog control 422,427 
OpenRead() method 424 
OpenWrite() method 424 

operators 68 

compound 154 

reference for G# operators 853 
optional parameters, using to set default values 636 
orderby clause 656, 670, 673 

OriginalSource property, RoutedEventArgs object 724 
OR operator. See \ (pipe symbol), under Symbols 


OR operator (| |) 434 
out parameters 

making methods return multiple values 634 
use by built-in value types’ TryParse() method 635 

Oven class 308 

OverFlowException 578 

overloaded constructors 789 

excuse management program 432 
taking a Stream 417 

overloaded methods 355 
building your own 381 
overriding methods 271 

abstract class methods 323 
hiding versus 268 
override keyword 260, 266 

using to inherit behavior 270 

P 

page-based navigation, Windows Store apps 658 
page header text, changing 23 
Page object 498 

creating instance of MenuMaker and using it for data 
context 517 

page root event handlers for swipes and taps 820 
pages 

choices for design and creation of 525 

in MWM applications 769 

laying out, using Graid versus StackPanel 515 

parameterless constructors 523, 528, 789 

parameters 104, 106 
capitalization 231 
masking fields 228, 231, 235 
method 61 

parent 250 
partial classes 65, 81 
PascalGase 231 
patterns. See design patterns 

PictureBox controls 96, 251, 469 

labs, #1 A Day at the Races 190, 192, 194 
updating 484 

pictures, user control to animate 789 
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pinch/zoom 684 
pixels 

in grid layout margins 502, 506 
use of term in XAML layout 507 

PointerOver state (controls) 778 

PointerPressed event handler 726 


polymorphism 331 

as principle of OOP 330 
popping up dialog boxes 421 

Pressed state (controls) 778 
animation of 780 
private access modifier 300, 315 

private fields 211-216 
declaring 231 

initializing with constructors 227 
private methods 213-214 

calculating intermediate costs in Dinner Party calcula¬ 
tor 232 

Program class 

code for desktop app stored in 93 
Main() method 92 

Programmer Reference for G# 853 
programming 

benefits of using G# with Visual Studio IDE 3 
G# code, syntax for 32 

code automatically generated by Visual Studio IDE 7 
programs 

anatomy of G# program 60 

breaking, restarting, and stopping in IDE 35 

IDE helping you code 58 

loops in 71 

operators in 68 

origins of G# programs 56 

running 35 

using debugger to see variables change 69 
variables in 66 

ProgressBar 

adding to Windows Store app 21 
updating for Windows Store app game 24 


properties 116 
automatic 225 

using backing fields instead of 336 
class 105 

get and set accessors as 229 
in interfaces 304 
initializing public properties 226 
interface requiring class to implement 296 
making encapsulation easier 223 
public, capitalization 231 
read-only 225, 226 
statements in 229 

using to fix Dinner Party calculator (example) 232— 
234 

versus fields 318 
XAML controls 20 

Properties window 
event handlers 42 

Search box, using to find XAML properties 28 
switching between event handlers and properties in 

42 

switching between events and properties in 46 
transforms 46 

using to change controls in Windows Store apps 22 
using to set up Windows Desktop app controls 90 

PropertyGhanged event 526 
raising 527 

protected access modifier 315 
protected keyword 317 

public access modifier 315, 856 
classes 65 
public fields 221 
initializing 226 
public interfaces 297 

public methods 221 

accessing private fields 214 
capitalization 231 

public properties 

capitalization 231 
initializing 226 

public void method 301 
Publisher-Subscriber pattern 740 
publishing apps to Windows Store 48 


projects 

creating Windows Store project 54 
project files (.csproj) 56 
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queries 

anatomy of 656 
editing with LINQPad 690 
LINQ 654, 667 

using join to combine two collections into one 
query 677 

query manager class 661 
query detail page 665 

queues 401 

converting to lists 404 
enqueuing and dequeuing 402 
FIFO (First In, First Out) 402 
foreach loop 404 

R 

\r (return character) 397, 425 

Racetrack Simulator project. See labs, #1 A Day at the 
Races 

Random class 168-169 
Next() method 355 
randomizing results 168—169 
random numbers, generation of 214 
readonly keyword 795 

read-only properties 225, 226 

Cost property, Dinner Party calculator 232 
ReadTextAsync() method 540 
receivers of events, connecting with senders 730 

Rectangle controls 

adding to Canvas 26 

turning into diamond by rotating 27 

rectangles 

using for Game boundaries 483 
refactoring 868—869 

references. See also reference variables 
interface 302—303 
object 303 

object versus interface 318 

passing by reference using ref modifier 635 

versus values 628 


reference variables 156-158, 730 
arrays of 167 

assigning to instance of subclasses 261 
for controls 181 
garbage collection 158 
how they work 172 

interface type, pointing to object implementing inter¬ 
face 331 

multiple references to single object 157 

accessing different methods and properties 311 
side effects of 160 
unintentional changes 165 
objects talking to other objects 170 
setting equal to instance of different class 331 
substituting subclass reference in place of base class 
264 

ref keyword 635 

reimbursement calculator for mileage 151—154 

Remote Debugger, using to sideload your app 49 

remote debugging, starting 50 

reserved words 150, 172, 182 

return statement 61, 104, 105 

return type 104, 105 

return value 61, 104 

risky code ， xxiii—xxx 

RoboBee class 306 

robust 584, 586, 592, 638 

rotations 27 

RoutedEventArgs object 724 
routed events 724 

creating Windows Store app to explore 725-729 
user controls 758 

rows and columns, resizing in Windows Store app page 
504 

Auto setting 507 

using * for row height or column width 507 
RSS feed, LINQto XML 873 



SaveAppBarButtonStyle static resource 543 
SaveFileDialog control 423, 427 
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Title property 427 
sbyte type 142 
scope 316 

ScrollViewer controls 

nesting only single control in 515 
Windows Store Go Fish! app page 502 

sealed access modifier 315 

sealed keyword 643 

select clause 670,679 

selecting and deselecting controls for editing 23 
SelectionGhanged event handler 664 
select new clause 677, 679 
Selector class 793 

semantic zoom control 684—690 

adding to comic books management app 686-691 
basic XAML pattern for 685 

senders of events, connecting with receivers 730 
separation of concerns 234, 278 

sequences 666 
defined 667 

Serializable attribute 445 

serialization 440—449 
data contract 546 
finalizers and 622 

finding where serialized files differ and altering them 
454 

making classes serializable 445 

making object serialize in Dispose() method 623 

object states 442 

reading and writing serialized files manually 453 
reading entire object 444 

serializing and deserializing deck of cards 446—447 
serializing objects out to file 448 
what happens to objects 441, 443 

SerializationException 584, 588 
BinaryFormatter 584 
set accessor 223, 229 

interface properties 304 

interfaces with get accessor without set accssor 301 
Settings charm 742 


using to open About popup 822 
SettingsPane class 742 
short-circuit operators 851 
short type 142, 144, 145 
ShowDialog() method 421, 423 
signature (method) 229 
similar behaviors 248 
similar code 248 

simulator in Visual Studio, running Windows Store apps 
558 

skew transforms 46 

Sloppy Joe’s Random Menu Item project 168-169 
building better menu with data binding 516-525 
Solution Explorer 5 
Form designer 96 
showing everything in a project 58 
switching between open project files 58 

solutions (.sin files), created by IDE 56 
SortBy field 374 
Sort() method 370 

Source property, getting or setting with two way binding 
513 


Source property, Image control, animating 789 

spec (specification) 390 

building a racetrack simulator 188 
splash screen, adding to a program 47 

Split App template, creating project with 692-700 
adding images files to Assets folder 697 
modifying code-behind in ItemsPage.xaml.es 696 
modifying code-behind in SplitPage.xaml.es 696 
modifying SplitPage.xaml to show comic book details 
698 


sprites 795 

Spy project 212—214 

SQL versus LINQ 657 


stack 401, 640 

converting to lists 404 

foreach loop 404 

LIFO (Last In, First Out) 403 
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popping items off 403 
versus heap 631—633 

StackPanel 10, 13, 42, 500, 502, 504, 509, 515, 520, 524 
adding human to Windows Store app game 26 
containing Open and Save buttons 543 
DataGontext property, setting 517, 523 
Excuse Manager project 560 
Grid layout versus 515 
using Document Outline to modify 25 
using to group TextBlock and GontentGontrol 23 

StackTrace property, Exception class 578 

Standard 130ItemTemplate 665 

StandardStyles.xaml file 543 

stars and bees, program that animates 796-805 

Start button, making it start the program 40 

Start Debugging button 70 

start tags 7 

state 759 

changes in, stopwatch app 764 
code related to timing 769 
thinking about, in MVVM 762 

statements 81 
defined 61 

ending with ; (semicolon) 75 
important points about 81 
in loops 71 

static keyword 115 

instance creation and 117 
static methods 115 
when to use 115 

static resources in XAML 522, 525, 528 
AppBar example 543 
Step Over (Debug) 70 
stopwatch app 761—768 

building analog stopwatch using same ViewModel 
781-785 

converters converting values for binding 770 
events in Model alerting app to state changes 764 
finishing touches 768 
View 765 
ViewModel 766 

Storyboard object 


Begin() method 789 
garbage collection for 791 

SetTarget() and SetTargetProperty() methods 789 
Storyboard tags 778 

Pressed storyboard, adding animation to 780 
Stream object 410 
Read() method 458 
StreamReader 417, 425 
hex dump 457 
versus File Streams 460 

streams 410 
chaining 418 
closing 425 
different types 411 
Dispose() method 430 
forgetting to close 412 

reading bytes from, using Stream.Read() 458 

serializing objects to 447 

things you can do with 411 

using file streams to build hex dumper 456 

using statements 430 

writing text to files 413 

StreamWriter 413—417, 425 

{0} and {1}, passing variables to strings 425 
Glose() method 413 
hex dump 457 

using with StreamReader 417 

versus FileStreams 460 

Write () and Write Line () methods 413, 414 

StringBuilder class 853 

string concatenation operator (+) 853 

converting numbers or Booleans to strings 147 
String.IsNullOrEmpty() 282 
string literals 413, 425 
String.PadLeft() method 852 
strings 

concatenating, automatic type conversions with + 
operator 148 

concatenation operator (+) 68 
converting numbers to 457 
converting to byte array 425 
extension methods 644 
formatting 205 
splitting 439 
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storage of data in memory as Unicode 449 
storing categories of data 352 
Substring() method 457 

string type 67 ， 142, 144, 151 
converting other types to 148 
structs 627 

boxed 632, 641 

setting one equal to another 630, 640 
versus classes 640 
versus objects 629 

styles 

altering appearance of a type of control 774-777 
altering appearance of every control of a specific type 
111 

AppBar buttons 543 
subclasses 248, 255, 259-261, 265, 272 

avoiding duplicate code, using inheritance 251 
child and 250 
constructors 273 

hiding superclass methods 268-269 

inheriting from base class 256 

modifying 259—260 

overriding inherited methods 260 

passing instance of 265 

upcasting 309, 331 

using instead of base classes 261 

subtraction operator. See - (minus sign), under Symbols 

superclass 250 

Suspending event, Windows Store apps 720—723 
modifying OnSuspending() event handler 722 
SuspensionManager class 721 

swipes and taps, handling in Invaders game 820, 824 

switch statements 437—439 

building new constructors with 439 
System.GomponentModel namespace 527 
System.Diagnostics.Debug.WriteLine() 496 
System.IO.File class 540 
System namespace 81 

System.Runtime.Serialization namespace 547 
System .Windows .Form class 497 
System.Windows.Forms.Gontrol class 497 


System.Windows.Forms namespace 93, 105, 129, 228 

T 

\t (tab character) 143, 413, 425 
Tab Control 239, 243 

TableLayoutPanel 427, 469 
Controls property 494 
tables versus collections 657 
Tab Pages property 243 
tags, XAML 7 
Take statement 670 
taps, page root event handlers for 820 

target portal player will drag human into (game example) 
27 

TargetType property, Style 775, 777 

Task class (or Task<T>) 557 

TemplateBinding markup 776 

Template property, controls 775 

templates. See also names of individual templates 
throughout 

creating enemy template for Windows Store app game 
25 

editing for enemy aliens (example) 46 
Standard 130ItemTemplate 665 

TextBlock controls 83 
binding path 512 

changing text and style in Windows Store app 23 
data binding to properties in MenuMaker (example) 
517 

data context 512 

Game Over text for Windows Store app 26 

Style property 73 

updating by pressing buttons 75 

using Document Outline to modify 25 

Windows Store Go Fish! app page 502 

TextBox controls 106 

Birthday Party project 243 

adding TexChanged event handler 245 
Text property, using to modify text 544 
two-way data binding 516, 517 
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TextGhanged event handler 245, 542, 544 
text editors 

building less simple editor 542-545 
Text property, XAML controls 514, 515 
this keyword 170, 316 

distinguishing fields from parameters with same name 
231, 235 

in extension method’s first parameter 642 
labs, #1 A Day at the Races 191 
using to raise event 709 

this variable 172 

threading 860 

throw, using to rethrow exceptions 596, 601 
tiles 47 

TimeNumberFormatGonverter class 770 
timers 

adding to manage gameplay 38 
LabelBouncer animation (example) 181 

Title property, SaveFileDialog 423, 427 
ToggleSwitch controls 725 

Toolbox window 5 

ALL XAML Controls section 21 
Common XAML Controls section 20 
expanding 89 

ToString() method 148, 205, 354 

adding to Card object (example) 378 
overriding and letting object describe itself 377 

transforms 

hands on analog stopwatch 783 
performing in Properties window 46 
rotating Rectangle 45 degrees 27 

try blocks 585, 587, 601. See also exception handling 
following in debugger 588-589 
getting with using statements 601 

try/catch/finally sequence for error handling 592. See 
also exception handling 

try/finally block 603. See also exception handling 

two-way data binding 513 

TextBox control in MenuMaker project 517 
type argument 364 


Type class and GetType() method 861 
typeof keyword 659 
types , xiii—xxx 

arguments, compatibility with types of parameters 
149 

arrays 166—167 
automatic casting in G# 148 
char 143 

common types in G# 142 
delegate 731 

different types holding different-sized values 172 
for whole numbers 142 
generic 367 

int, string, and bool types 67 
literals 143 

multiple references and their side effects 160—162 
object 143 

referring to objects with reference variables 156-158 
return type 104 

storing really huge and really tiny numbers 143 
value types 146 
variable 66—67, 144 

typing game, building 176—179 

u 

UIGommandlnvokedHandler 742 
UIGommand object 539 
UIElement base class 795 
uint type 142 

UI (user interface) 

creating controls with G# code 786 
creating using Visual Designer 3 

ulong type 142 

Undo command (IDE) 81 

undoing changes to controls 23 
unexpected input 586 

unhandled exceptions 582 
versus exceptions 592 
Unicode 397,448, 460,514, 561 
converting text to 449 
units, device-independent 507 
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upcasting 309 

but not downcasting 312 

entire list, using IEnumerable<T> 380 

interfaces 311 

using subclass instead of base class 331 
Up Close, access modifiers 316—317 

user controls 753-759 
AnalogStopwatch 781 
Animate dimage 789 
containing other controls 759 
objects extending UserGontrol base class 758 
stopwatch app 765 

event handlers for 768 
Windows Phone app 838 

Windows Phone app, BeeAttackGameControl 842 
ushort type 142 

using statements 34, 430, 603 
Dispose() 620 
exception handling 601 
for desktop apps 92, 94 

using System. Windows. For ms 93 
in G# programs 60 

V 

value converters 770—773 

automatically converting values for binding 770 
working with many different types 772 

value parameter, set accessors 229 
values versus references 628 

value types 142， 172 
bool (see bool type) 
byte (see byte type) 
casting 146—148 
changing 172 
char (see char type) 
decimal (see decimal type) 
double (see double type) 
int (see int type) 
long (see long type) 
more information on 146 
sbyte 142 

short (see short type) 
structs as 629 

TryParse() method using out parameters 635 


uint 142 
ulong 142 
ushort 142 

variables matching types of parameters 149 
versus objects 628 

variables 66， 144 

adding to form 130, 132 
assigning values to 67 

data type and 146 
data types 142 

declarations with name and type 75 
declaring 66 

matching types of parameters 149 
naming 154 
objects as 155 

reference (see reference variables) 
renaming 869 

using debugger to see changes in 69 
values of 66 

var keyword 654, 680 

VerticalAlignment property, controls 22 

vertical bars 434 

View 749. See also MWM pattern 
building for simple stopwatch 765 
rules for MWM apps 769 

stopwatch app, buttons calling methods in ViewModel 
768 

ViewModel 749. See also MWM pattern 
BasketballRoster project 755-757 
rules for MWM apps 769 
stopwatch app 766 

using Model statement at top of classes 759 
virtual keyword 260, 266 

using to inherit behavior 270 
virtual machines 171 
virtual methods 265 
Visibility enum 772 
Visible property, forms or controls 99 

Visual Designer 3 

editing user interface 5 

visual states, making controls respond to changes 778 

Visual Studio 2008 Express 
setting up xxxviii 
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Visual Studio for Windows Phone IDE 834 
Visual Studio IDE 2—7 

code automatically generated by, handling of 81 

creating new project 4 

different editions, look of 4 

editions and versions of 7 

exploring different parts of 5 

Extract Method feature, Refactor menu 869 

helping you code 58, 62 

making changes in, changes to code 96 

Remote Debugger 49 

Reset Window Layout, from Window menu 35 
running Windows Store apps in simulator 558 
Undo command, and automatically generated code 
81 

using with G#, capabilities of 3 
Visual Studio 2012 for Windows Desktop 89 
Watch windows in Visual Studio 2012 for Windows 
8 498 

XAML designer, giving message to rebuild code 556 
void keyword, preceding methods 61 

void method 

interfaces 300 
public 301 

void return type 104, 105, 121, 131 

W 

Watch window 70 
where clause 656, 670 

while loops 71, 77—81, 100 

continue and break keywords in 850 
infinite loop 99 

whitespace, extra, in G# code 75 
Windows 8 11, 874 
Windows 8 Gamp Training Kit 846 
Windows App Certification Kit 48 
Windows calculator 143 

Windows Desktop 

building an app 87-100 
animations 98—100 

changes made in IDE and code changes 96 
changing program’s entry point 94 


entry point, Main() method 92 
MessageBox.Show() method 95 
nuts and bolts of desktop apps 93 
Windows Forms Application project, creating 88 

Windows Phone app, building 831-844 

adding BeeAttackGameGontrol to main page 844 
Bee Attack game 832 

BeeAttackGameGontrol to manage the game 842 

before you begin 833 

G# code-behind for BeeGontrol 839 

creating new Windows Phone project 834 

Model, View, and ViewModel for Bee Attack app 836 

user controls 838 

Windows Phone Dev Center account 833 
Windows Presentation Foundation. See WPF 
Windows Presentation Foundation (WPF) 874 
Windows Runtime, namespaces for tools in 57 
Windows Settings charm, using 742 
Windows.Storage.IStorageFolder 548 

Windows. Storage namespace 540 
KnownFolders class 550 
Windows Store apps , xxi—xxx 

building with WPF for operating systems before Win¬ 
dows 8 11 

creating new project for 54 

data binding, connecting XAML pages to classes 512 
exploring app page navigation using the IDE 659 
INotifyPropertyChanged, letting bound objects send 
updates 526 

learning more about programming 846 
managingJimmy 5 s comics collection 658, 660—666, 
668 

combining values into groups 674 
semantic zoom 686—690 

Split App for navigating data 692—700 
.NET for, tools for building apps 57 
protecting your filesystem 548 
publishing apps to Windows Store 48 
rebuilding Excuse Manager as 558-568 
redesigning GoFish! form as app page 500-506 

finishing conversion 528—534 
page layout starting with controls 502 
rows and columns resizing to match screen size 
504 
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using grid system to lay out pages 506 
redesigning Windows Desktop forms as 508-511 
running in Visual Studio simulator 558 
superior IO tools 537 
text editor 542-545 
using awit to be more responsive 538 
using data binding to build better menu 516-521 
using data template to display objects 524 
using events for process lifetime management 720— 
723 

using static resources to declare objects in XAML 522 
using XAML to create UI objects 498 

Windows UI controls. See controls 

Windows.UI namespace 786 

Win do ws. UI. Xaml. G onrols namespace 57 

Windows.UI.Xaml namespace 795 

WinForms apps 

GDI+ grpahics 489 
reasons for learning 515 

using BackgroundWorker to make apps responsive 
858-860 

using object graph set up by IDE 494 
using System.IO.File to read/write files 540 
versus Windows Store apps 489 

WPF (Windows Presentation Foundation) 11, 13, 874 

X 

XAML 489 

application code 11 

changes to code from changes made in IDE 55 
combining with G#, creating wisual programs 3 
controls, containing text and other controls 514 
data binding in 512 
defined 7 

editing templates 46 

file created by Solution Explorer on creating new 
project in Visual Studio 4 
flexibility with tag order 508 
generated for controls dragged from Toolbox onto 
page 21 

page design with, WinForms versus 515 


properties 20, 28, 37 

using to change controls 22 
redesigning Windows Desktop forms 508—511 
using static resources to declare objects in 522 
using to create UI for Windows Store apps 498 
Windows Presentation Foundation (WPF) 874 

XML 

comments 97, 848 
LINQto XML 872 
namespace 547, 843 

xmlns 522, 755 

output of data contract serializer 551 
x:Name and x:Key properties, static resources 525 
x:Name property 73 
XOR operator ( A ) 863 
XOR operator (〜) 852 

Y 

yield return, using to create enumerable objects 865-867 

z 

zoom, semantic zoom control 684—690 

Zoo Simulator project 250-256 
class hierarchy 254 
extending base class 255 
inheriting from base class 255 
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